Opovid Ruby

This directory contains the Ruby runtime for Opovid.

The Ruby gems require Ruby 4.0 or newer.

Current gems:

  • opovid-core: user-first, actor-backed task, question, check, and execution-report primitives
  • opovid-memory: reusable actor-local state ability
  • opovid-spec: use-case authoring and compilation support

Examples:

  • examples/plain-ruby-memory-basic: plain Ruby user-first flow with typed user-owned state
  • examples/rails-service-basic: Rails-style service-flow shape using a typed scenario context
  • examples/rails-request-basic: Rails-style request-flow shape using a thin request ability

Browser flows are intentionally handled in the TypeScript runtime with Playwright rather than in the Ruby runtime.

Opovid::User is the preferred top-level facade. Opovid::Actor remains the lower-level compatibility API. RememberTheState is still available for small migration-friendly state bags.

Run

bundle exec rake

Use Locally

From this directory:

bundle install
bundle exec rake

Then depend on:

gem "opovid-core"
gem "opovid-memory"
gem "opovid-spec"

Keep the Ruby gems on the same version, the same way the TypeScript and Java runtimes stay aligned.

Public Release

Tagged releases are published through the manual GitLab release pipeline in .gitlab/ci/release.yml.

Expected credential:

  • RUBYGEM_TOKEN: RubyGems API key with permission to push opovid-core, opovid-memory, and opovid-spec