plutonium 0.46.0 → 0.48.0

data/docs/superpowers/plans/2026-04-14-plutonium-testing.md.tasks.json

@@ -0,0 +1,21 @@
+{
+  "planPath": "docs/superpowers/plans/2026-04-14-plutonium-testing.md",
+  "tasks": [
+    {"id": 1, "subject": "Create Plutonium::Testing module skeleton and autoload entry", "status": "pending", "planTaskNumber": 1},
+    {"id": 2, "subject": "Implement shared DSL and portal resolution", "status": "pending", "blockedBy": [1], "planTaskNumber": 2},
+    {"id": 10, "subject": "Implement portal-scoped AuthHelpers", "status": "pending", "blockedBy": [2], "planTaskNumber": 3},
+    {"id": 3, "subject": "Implement ResourceCrud concern", "status": "pending", "blockedBy": [2, 10], "planTaskNumber": 4},
+    {"id": 4, "subject": "Implement ResourcePolicy concern", "status": "pending", "blockedBy": [2], "planTaskNumber": 5},
+    {"id": 5, "subject": "Implement ResourceDefinition concern", "status": "pending", "blockedBy": [2, 3], "planTaskNumber": 6},
+    {"id": 6, "subject": "Implement ResourceInteraction concern", "status": "pending", "blockedBy": [1], "planTaskNumber": 7},
+    {"id": 7, "subject": "Implement ResourceModel concern", "status": "pending", "blockedBy": [2], "planTaskNumber": 8},
+    {"id": 8, "subject": "Implement NestedResource concern", "status": "pending", "blockedBy": [2, 10], "planTaskNumber": 9},
+    {"id": 9, "subject": "Implement PortalAccess concern", "status": "pending", "blockedBy": [10], "planTaskNumber": 10},
+    {"id": 11, "subject": "Implement pu:test:install generator", "status": "pending", "blockedBy": [1], "planTaskNumber": 11},
+    {"id": 12, "subject": "Implement pu:test:scaffold generator", "status": "pending", "blockedBy": [1], "planTaskNumber": 12},
+    {"id": 14, "subject": "Write plutonium-testing skill documentation", "status": "pending", "blockedBy": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12], "planTaskNumber": 13},
+    {"id": 15, "subject": "Add VitePress docs guide for testing", "status": "pending", "blockedBy": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12], "planTaskNumber": 14},
+    {"id": 13, "subject": "Migrate in-repo shared_tests to use Plutonium::Testing concerns", "status": "pending", "blockedBy": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12], "planTaskNumber": 15}
+  ],
+  "lastUpdated": "2026-04-14T00:00:00Z"
+}

data/docs/superpowers/specs/2026-04-14-plutonium-testing-design.md

@@ -0,0 +1,364 @@
+# Plutonium::Testing — Design Spec
+
+**Date:** 2026-04-14
+**Status:** Approved (pre-implementation)
+**Audience:** End-app developers using Plutonium
+
+---
+
+## Goal
+
+Ship `Plutonium::Testing` — a public, opt-in collection of Minitest concerns that give Plutonium app developers default test coverage for resources, policies, definitions, interactions, models, nested scoping, portal access, and authentication. Pair the module with a `plutonium-testing` skill and a Rails generator (`pu:test:scaffold`) that produces ready-to-run test files per (resource × portal) pairing.
+
+## Non-Goals
+
+- RSpec support (Minitest only for first cut).
+- A test data builder / factory layer (out of scope; callers wire their own factories or fixtures).
+- Replacing Plutonium's own internal `test/support/shared_tests/` ahead of the public API landing — the migration is the *last* implementation step and serves as dogfooding.
+
+## Approach
+
+- **Loading model:** opt-in `require "plutonium/testing"` in the consumer's `test/test_helper.rb`. No autoload, no production cost. Mirrors `ActiveSupport::Testing::*` conventions.
+- **Granularity:** one concern per category. Callers `include` exactly what they need. No umbrella module.
+- **DSL + stub methods:** declarative config (`resource_tests_for Post, portal: :admin`) for shape; abstract stub methods (raising `NotImplementedError`) for test data the caller must provide.
+- **Portal-centric:** the `portal:` symbol is the single unit of configuration. It resolves to path prefix, default sign-in helper, expected scoping, and allowed action set by introspecting the mounted portal engine. Same resource × different portal = different test file.
+
+---
+
+## Architecture
+
+### File Layout
+
+```
+lib/plutonium/
+  testing.rb                           # top-level require; loads submodules
+  testing/
+    dsl.rb                             # shared `resource_tests_for` + portal resolution
+    auth_helpers.rb                    # login_as / sign_out / with_portal (portal-aware)
+    resource_crud.rb                   # integration CRUD matrix
+    resource_policy.rb                 # permit? × action × role; relation_scope filtering
+    resource_definition.rb             # fields/inputs/displays/columns/scopes smoke
+    resource_interaction.rb            # interaction outcome assertions
+    resource_model.rb                  # associated_with, SGID, has_cents
+    nested_resource.rb                 # tenant-scoped CRUD + boundary assertions
+    portal_access.rb                   # cross-portal access boundaries
+
+lib/generators/pu/test/
+  install/install_generator.rb         # one-time setup
+  install/templates/plutonium_testing.rb.tt
+  scaffold/scaffold_generator.rb       # per-resource × portal scaffold
+  scaffold/templates/integration_test.rb.tt
+  scaffold/templates/policy_test.rb.tt
+  scaffold/templates/definition_test.rb.tt
+
+test/plutonium/testing/                # tests for the testing module itself
+  dsl_test.rb
+  auth_helpers_test.rb
+  resource_crud_test.rb
+  resource_policy_test.rb
+  resource_definition_test.rb
+  resource_interaction_test.rb
+  resource_model_test.rb
+  nested_resource_test.rb
+  portal_access_test.rb
+
+test/generators/pu/test/
+  install_generator_test.rb
+  scaffold_generator_test.rb
+
+.claude/skills/plutonium-testing/
+  SKILL.md
+
+docs/guides/testing.md
+```
+
+### Loading
+
+`lib/plutonium/testing.rb` is the entry point:
+
+```ruby
+require "plutonium/testing/dsl"
+require "plutonium/testing/auth_helpers"
+require "plutonium/testing/resource_crud"
+require "plutonium/testing/resource_policy"
+require "plutonium/testing/resource_definition"
+require "plutonium/testing/resource_interaction"
+require "plutonium/testing/resource_model"
+require "plutonium/testing/nested_resource"
+require "plutonium/testing/portal_access"
+```
+
+Consumers add `require "plutonium/testing"` to `test/test_helper.rb` (the `pu:test:install` generator does this for them).
+
+---
+
+## DSL
+
+`Plutonium::Testing::DSL` is included by every concern. Provides one class-level method:
+
+```ruby
+resource_tests_for ResourceClass,
+  portal:      :admin,                           # required: portal symbol
+  path_prefix: "/admin",                         # optional: explicit override
+  parent:      :organization,                    # optional: nested-resource parent
+  actions:     %i[index show new create edit update destroy],  # optional: opt-in set
+  skip:        %i[destroy]                       # optional: opt-out individual tests
+```
+
+The portal symbol drives:
+
+| Derived from portal | Example for `:admin` | Example for `:org` |
+|---|---|---|
+| `path_prefix` | `/admin` | `/org/:organization_id` |
+| Default sign-in | admin Rodauth strategy | org-member Rodauth strategy |
+| Expected entity scoping | unscoped | scoped to `@organization` |
+| Allowed action set | from definition | from definition |
+
+DSL stores the current portal in a test-class-local attr; `AuthHelpers` reads it as default when no `portal:` kwarg is given.
+
+### Cross-portal tests
+
+For tests that touch multiple portals (`PortalAccess` concern), `portal:` is an explicit kwarg on helper calls:
+
+```ruby
+login_as(@admin, portal: :admin)
+login_as(@user,  portal: :org)
+with_portal(:org) { get "/org/posts" }    # block form
+```
+
+---
+
+## Concerns
+
+### `Plutonium::Testing::ResourceCrud`
+
+Generates index / show / new / create / edit / update / destroy integration tests against the portal-mounted resource.
+
+**Stubs (caller must implement):**
+```ruby
+def create_resource!         # -> persisted record
+def valid_create_params      # -> Hash for POST
+def valid_update_params      # -> Hash for PATCH
+```
+
+Sign-in is automatic from the portal's auth strategy unless the caller overrides `sign_in_for_tests(account, portal:)`.
+
+### `Plutonium::Testing::ResourcePolicy`
+
+Asserts the `permit?` matrix across action × role and `relation_scope` filtering.
+
+**Stubs:**
+```ruby
+def policy_roles             # -> { admin: -> { @admin }, member: -> { @user } }
+def policy_record            # -> record instance under test
+def policy_matrix            # -> { index: %i[admin member], destroy: %i[admin] }
+```
+
+### `Plutonium::Testing::ResourceDefinition`
+
+Smoke-tests that all registered fields/inputs/displays/columns/scopes/filters render without error against a persisted record. Introspects the definition class via `Plutonium::Definition::DefineableProps`. **No caller stubs required** for the happy path.
+
+### `Plutonium::Testing::ResourceInteraction`
+
+Outcome-assertion helpers for `Plutonium::Resource::Interaction` subclasses.
+
+**Helpers:**
+- `assert_interaction_success(interaction_class, **input)`
+- `assert_interaction_failure(interaction_class, **input)`
+- `assert_interaction_redirect(interaction_class, to:, **input)`
+- `assert_interaction_renders(interaction_class, view:, **input)`
+
+**Stubs:**
+```ruby
+def interaction_class
+def valid_interaction_input
+```
+
+### `Plutonium::Testing::ResourceModel`
+
+Covers `associated_with` scope behavior, SGID routing, and `has_cents` money helpers. DSL flags select which features to test:
+
+```ruby
+resource_tests_for Post, portal: :admin,
+  associated_with: :organization,
+  sgid_routing:    true,
+  has_cents:       %i[price]
+```
+
+Only generates test methods for enabled features.
+
+### `Plutonium::Testing::NestedResource`
+
+Same CRUD matrix as `ResourceCrud` but asserts scope boundaries: index excludes records from sibling tenants; show on a sibling-tenant record returns 404.
+
+**Stubs:**
+```ruby
+def parent_record!           # -> persisted parent/tenant
+def other_parent_record!     # -> a different tenant for boundary tests
+```
+
+### `Plutonium::Testing::PortalAccess`
+
+Cross-portal access boundaries.
+
+**DSL:**
+```ruby
+portal_access_matrix \
+  admin:  %i[admin_portal],
+  member: %i[org_portal storefront_portal]
+```
+
+Asserts unauthorized portals return 403 or redirect to login.
+
+---
+
+## Auth Helpers
+
+`Plutonium::Testing::AuthHelpers` is included transitively by every concern.
+
+**Public API:**
+```ruby
+login_as(account)                    # uses portal from DSL
+login_as(account, portal: :admin)    # explicit override
+sign_out                              # uses portal from DSL
+sign_out(portal: :admin)
+current_account                       # uses portal from DSL
+current_account(portal: :admin)
+with_portal(:org) { ... }            # scoped portal switch
+```
+
+**Implementation:**
+- Looks up the portal's declared auth strategy from the mounted portal engine config.
+- For Rodauth (stock Plutonium): fakes the session cookie directly; no full login round-trip.
+- **Override hook** for non-Rodauth apps: caller defines `sign_in_for_tests(account, portal:)` and `AuthHelpers` defers to it.
+
+The `pu:test:install` generator scaffolds a commented-out override in `test/support/plutonium_testing.rb`.
+
+---
+
+## Generators
+
+### `pu:test:install`
+
+One-time project setup. Idempotent.
+
+- Adds `require "plutonium/testing"` to `test/test_helper.rb` (no-op if present).
+- Creates `test/support/plutonium_testing.rb` with commented-out override stubs for non-Rodauth auth.
+
+### `pu:test:scaffold`
+
+Per-resource scaffold. Produces one file per (resource × portal).
+
+```bash
+rails g pu:test:scaffold Blogging::Post --portals=admin,org
+rails g pu:test:scaffold Blogging::Post --portals=admin --concerns=crud,policy,definition
+rails g pu:test:scaffold Blogging::Post --portals=org --parent=organization --dest=blogging
+```
+
+**Flags:**
+- `--portals=admin,org` (required) — emits one file per portal.
+- `--concerns=crud,policy,definition,nested,model,interaction,portal_access` (default: `crud,policy,definition`).
+- `--parent=organization` — wires `NestedResource` parent stub.
+- `--dest=main_app|package_name` — output destination (matches `pu:res:scaffold` convention).
+
+**Example output** (`test/integration/admin_portal/blogging_posts_test.rb`):
+
+```ruby
+require "test_helper"
+
+class AdminPortal::BloggingPostsTest < ActionDispatch::IntegrationTest
+  include Plutonium::Testing::ResourceCrud
+  include Plutonium::Testing::ResourcePolicy
+  include Plutonium::Testing::ResourceDefinition
+
+  resource_tests_for Blogging::Post, portal: :admin
+
+  setup do
+    @admin = create_admin!       # TODO: replace with your factory
+    login_as(@admin)
+  end
+
+  def create_resource!
+    Blogging::Post.create!(title: "X", body: "...")    # TODO: adjust
+  end
+
+  def valid_create_params
+    { title: "New", body: "..." }                       # TODO: adjust
+  end
+
+  def valid_update_params
+    { title: "Updated" }                                # TODO: adjust
+  end
+
+  def policy_roles
+    { admin: -> { @admin } }                            # TODO: add other roles
+  end
+
+  def policy_record
+    create_resource!
+  end
+
+  def policy_matrix
+    { index: %i[admin], show: %i[admin], create: %i[admin],
+      update: %i[admin], destroy: %i[admin] }           # TODO: tighten
+  end
+end
+```
+
+Stub method bodies are pre-filled with best-guess values from model introspection (column types, associations).
+
+---
+
+## Skill
+
+`.claude/skills/plutonium-testing/SKILL.md` follows the existing skill conventions in `.claude/skills/`.
+
+**Frontmatter `description`:**
+> Use BEFORE writing tests for a Plutonium resource, running `pu:test:scaffold`, or including `Plutonium::Testing::*` concerns. Covers the full testing toolkit: CRUD, policy, definition, interaction, model, nested, portal access, and auth helpers.
+
+**Sections:**
+1. When to use
+2. Quick start (install + scaffold + first run)
+3. DSL reference (`resource_tests_for` keywords + portal resolution table)
+4. Concerns catalog (one section per concern with stub contract + example)
+5. Auth helpers
+6. Generator reference (`pu:test:install`, `pu:test:scaffold` flags)
+7. Customization & escape hatches (non-Rodauth auth, skipping defaults, custom assertions)
+8. Common pitfalls (forgotten stubs, portal mismatch, tenant leakage)
+
+The top-level `plutonium` router skill gets one new entry pointing to `plutonium-testing`.
+
+---
+
+## Docs
+
+`docs/guides/testing.md` mirrors the skill content for human-facing documentation. Linked from the guides section in `docs/.vitepress/config.ts`.
+
+---
+
+## In-Repo Adoption (Dogfooding)
+
+After all concerns and generators land, port the dummy app's tests:
+
+- `test/integration/admin_portal/resources_test.rb` and the other portal test files migrate to `Plutonium::Testing::*` concerns.
+- `test/support/shared_tests/blogging_post_tests.rb` and `catalog_product_tests.rb` are deleted or shrunk to anything that doesn't fit the generic concerns.
+
+Acceptance: zero coverage loss (compare test method counts before/after) and the entire suite still passes across `rails-7`, `rails-8.0`, `rails-8.1` appraisals.
+
+---
+
+## Implementation Sequence
+
+1. Module skeleton + entry point (`lib/plutonium/testing.rb`).
+2. Shared DSL + portal resolution.
+3. Auth helpers.
+4. Each concern (parallelizable after #2 and #3): ResourceCrud, ResourcePolicy, ResourceDefinition, ResourceInteraction, ResourceModel, NestedResource, PortalAccess.
+5. Generators: `pu:test:install`, then `pu:test:scaffold`.
+6. Skill + docs.
+7. In-repo migration (last — dogfoods the public API).
+
+---
+
+## Open Questions
+
+None at design time. Implementation may surface portal-resolution edge cases (engines mounted at non-standard paths, multiple engines per account type) that warrant follow-up.

data/gemfiles/rails_8.1.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    plutonium (0.45.3)
+    plutonium (0.47.0)
       action_policy (~> 0.7.0)
       listen (~> 3.8)
       pagy (~> 43.0)
@@ -101,6 +101,8 @@ GEM
       securerandom (>= 0.3)
       tzinfo (~> 2.0, >= 2.0.5)
       uri (>= 0.13.1)
+    addressable (2.9.0)
+      public_suffix (>= 2.0.2, < 8.0)
     ansi (1.5.0)
     appraisal (2.5.0)
       bundler
@@ -118,6 +120,15 @@ GEM
     bundler-audit (0.9.3)
       bundler (>= 1.2.0)
       thor (~> 1.0)
+    capybara (3.40.0)
+      addressable
+      matrix
+      mini_mime (>= 0.1.3)
+      nokogiri (~> 1.11)
+      rack (>= 1.6.0)
+      rack-test (>= 0.6.3)
+      regexp_parser (>= 1.5, < 3.0)
+      xpath (~> 3.2)
     chunky_png (1.4.0)
     combustion (1.5.0)
       activesupport (>= 3.0.0)
@@ -166,6 +177,7 @@ GEM
       net-pop
       net-smtp
     marcel (1.1.0)
+    matrix (0.4.3)
     mini_mime (1.1.5)
     minitest (6.0.2)
       drb (~> 2.0)
@@ -243,6 +255,7 @@ GEM
     psych (5.3.1)
       date
       stringio
+    public_suffix (7.0.5)
     puma (7.2.0)
       nio4r (~> 2.0)
     rabl (0.17.0)
@@ -302,6 +315,7 @@ GEM
     regexp_parser (2.11.3)
     reline (0.6.3)
       io-console (~> 0.5)
+    rexml (3.4.4)
     roda (3.102.0)
       rack
     rodauth (2.42.0)
@@ -339,7 +353,14 @@ GEM
       rubocop-ast (>= 1.47.1, < 2.0)
     ruby-next-core (1.2.0)
     ruby-progressbar (1.13.0)
+    rubyzip (3.2.2)
     securerandom (0.4.1)
+    selenium-webdriver (4.43.0)
+      base64 (~> 0.2)
+      logger (~> 1.4)
+      rexml (~> 3.2, >= 3.2.5)
+      rubyzip (>= 1.2.2, < 4.0)
+      websocket (~> 1.0)
     semantic_range (3.1.1)
     sequel (5.102.0)
       bigdecimal
@@ -389,11 +410,14 @@ GEM
     unicode-emoji (4.2.0)
     uri (1.1.1)
     useragent (0.16.11)
+    websocket (1.2.11)
     websocket-driver (0.8.0)
       base64
       websocket-extensions (>= 0.1.0)
     websocket-extensions (0.1.5)
     wisper (2.0.1)
+    xpath (3.2.0)
+      nokogiri (~> 1.8)
     yaml (0.4.0)
     zeitwerk (2.7.5)
 
@@ -405,6 +429,7 @@ DEPENDENCIES
   bcrypt
   brakeman
   bundle-audit
+  capybara
   combustion
   importmap-rails
   minitest
@@ -417,6 +442,7 @@ DEPENDENCIES
   rodauth-rails
   rotp
   rqrcode
+  selenium-webdriver
   sequel-activerecord_connection
   sqlite3
   standard

data/lib/generators/pu/test/install/install_generator.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative "../../lib/plutonium_generators"
+
+module Pu
+  module Test
+    class InstallGenerator < Rails::Generators::Base
+      include PlutoniumGenerators::Generator
+
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Install Plutonium::Testing scaffolding"
+
+      def install
+        add_require_to_test_helper
+        copy_support_file
+      end
+
+      private
+
+      def add_require_to_test_helper
+        helper = "test/test_helper.rb"
+        return unless File.exist?(helper)
+        line = %(require "plutonium/testing")
+        return if File.read(helper).include?(line)
+        append_to_file helper, "\n#{line}\n"
+      end
+
+      def copy_support_file
+        copy_file "plutonium_testing.rb", "test/support/plutonium_testing.rb"
+      end
+    end
+  end
+end

data/lib/generators/pu/test/install/templates/plutonium_testing.rb.tt

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# Plutonium::Testing project hooks.
+#
+# Override authentication for non-Rodauth setups by defining a top-level helper
+# that gets included into integration tests:
+#
+# module PlutoniumTestingOverrides
+#   def sign_in_for_tests(account, portal:)
+#     # your custom auth flow here
+#   end
+# end
+#
+# ActiveSupport::TestCase.include(PlutoniumTestingOverrides)

data/lib/generators/pu/test/scaffold/scaffold_generator.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require_relative "../../lib/plutonium_generators"
+
+module Pu
+  module Test
+    class ScaffoldGenerator < Rails::Generators::NamedBase
+      include PlutoniumGenerators::Generator
+
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Scaffold Plutonium::Testing tests for a resource across one or more portals"
+
+      class_option :portals, type: :array, required: true,
+        desc: "Portals to scaffold tests for (e.g. admin,org)"
+      class_option :concerns, type: :array, default: %w[crud policy definition],
+        desc: "Concerns to include (crud,policy,definition,nested,model,interaction)"
+      class_option :parent, type: :string, desc: "Parent association for nested resources"
+      class_option :dest, type: :string, default: "main_app",
+        desc: "main_app or package name"
+
+      def scaffold
+        options[:portals].each { |portal| scaffold_for_portal(portal) }
+      end
+
+      private
+
+      CONCERN_MAP = {
+        "crud" => "ResourceCrud",
+        "policy" => "ResourcePolicy",
+        "definition" => "ResourceDefinition",
+        "model" => "ResourceModel",
+        "interaction" => "ResourceInteraction",
+        "nested" => "NestedResource",
+        "portal_access" => "PortalAccess"
+      }.freeze
+
+      def concern_module_name(concern)
+        CONCERN_MAP.fetch(concern) { concern.camelize }
+      end
+
+      def scaffold_for_portal(portal)
+        @portal = portal
+        @resource_class = name
+        @file_name = name.underscore.tr("/", "_")
+        @class_name = "#{portal.camelize}Portal::#{name.tr("::", "")}Test"
+        @concerns = options[:concerns]
+        @parent = options[:parent]
+        target_dir = (options[:dest] == "main_app") ? "test/integration" : "packages/#{options[:dest]}/test/integration"
+        target = "#{target_dir}/#{portal}_portal/#{@file_name}_test.rb"
+        template "integration_test.rb.tt", target
+      end
+    end
+  end
+end

data/lib/generators/pu/test/scaffold/templates/integration_test.rb.tt

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+class <%= @class_name %> < ActionDispatch::IntegrationTest
+<% @concerns.each do |c| -%>
+  include Plutonium::Testing::<%= concern_module_name(c) %>
+<% end -%>
+
+  resource_tests_for <%= @resource_class %>,
+    portal: :<%= @portal %><% if @parent %>,
+    parent: :<%= @parent %><% end %>
+
+  setup do
+    # TODO: replace with your factories.
+    @account = nil
+    login_as(@account)
+  end
+
+<% if @concerns.include?("crud") -%>
+  def create_resource!
+    <%= @resource_class %>.create!(
+      # TODO: fill in valid attributes
+    )
+  end
+
+  def valid_create_params
+    {} # TODO
+  end
+
+  def valid_update_params
+    {} # TODO
+  end
+<% end -%>
+<% if @concerns.include?("policy") -%>
+
+  def policy_roles
+    {<%= @portal %>: -> { @account }}
+  end
+
+  def policy_record
+    create_resource!
+  end
+
+  def policy_matrix
+    {
+      index: %i[<%= @portal %>],
+      show: %i[<%= @portal %>],
+      create: %i[<%= @portal %>],
+      update: %i[<%= @portal %>],
+      destroy: %i[<%= @portal %>]
+    }
+  end
+<% end -%>
+<% if @concerns.include?("nested") && @parent -%>
+
+  def parent_record!
+    # TODO: return the current tenant for this test
+  end
+
+  def other_parent_record!
+    # TODO: return a sibling tenant
+  end
+<% end -%>
+end

data/lib/plutonium/action/interactive.rb

@@ -31,7 +31,8 @@ module Plutonium
       #
       # @return [String, nil] The confirmation message or nil if not applicable
       def confirmation
-        super || (@immediate ? "#{label}?" : nil)
+        return @confirmation unless @confirmation.nil?
+        @immediate ? "#{label}?" : nil
       end
 
       # Factory for creating Interactive actions