Skip to content

ActingFor 0.1.2

Latest

Choose a tag to compare

@github-actions github-actions released this 14 Nov 03:13
adce638

ActingFor 0.1.2

Changes

  • Constraint evaluation now uses actual Symbol keys in Context, consistently with Audit sanitization. An ordinary Hash containing both :amount and "amount" uses the Symbol value for authorization and selected Audit Context.
  • Getting Started shows how a host-generated authorization_id can correlate an authorization AuditEvent with host operation logs through context and audit_context_keys. This is an application convention, not a new Gem API or schema field.
  • Public API regression tests cover Context key handling and the interaction with unconstrained Delegations.

Compatibility and limitations

ActiveSupport::HashWithIndifferentAccess stores String keys. A constraint requiring an actual Symbol key therefore does not match that Context in 0.1.2, even if Symbol lookup succeeds. This may change results for applications that relied on the previous behavior. Build an ordinary Hash from trusted, validated host values, for example { amount: product.price }.

The entire Hash is not rejected: an independently matching unconstrained Delegation still participates in authorization. In particular, when a constrained require_approval Delegation stops matching, an unconstrained allow can still result in allow.

Host Authorization remains the host application's responsibility. require_approval is not permission to execute. AuditEvent records authorization, not a guarantee that the business operation committed; authorization_id is neither an idempotency key nor an approval token by itself.

Installation

gem "acting_for", "~> 0.1.2"
bundle install

New applications install the Engine migrations with bin/rails acting_for:install:migrations and bin/rails db:migrate. Upgrading from 0.1.1 introduces no schema changes.

Verified environments

  • Core CI: Ruby 3.4 / 4.0 × Rails 8.0 / 8.1, all four combinations passed with 355 runs / 910 assertions / 0 failures / 0 errors / 0 skips. RuboCop passed.
  • Published Gem: normal RubyGems version installation into a fresh Rails 8.0 application, PostgreSQL 16, Engine migrations and 8 public API / Audit scenarios (85 checks) passed before this GitHub Release was created.
  • Supported versions: Ruby >= 3.4 and < 4.1; Rails >= 8.0 and < 8.2.

Artifact identity

  • Release date: 2026-11-14
  • Release Source: adce638556e8e8b5a048fbd7241cd9df2808db7b
  • Tag: v0.1.2 (fixed to the Release Source; later documentation commits do not move this tag)
  • Gem: acting_for-0.1.2.gem
  • Payload: 17 files / 16,384 bytes
  • SHA256: ac2b5ceb93aa3896aab9891bca73424d808629ec3e3109e7fd3d2313f63fdaab
  • RubyGems metadata and distributed Gem checksum match the pre-publication artifact.

The packaged README is the frozen pre-publication snapshot. Current installation and release documentation is maintained on main after publication.

References