rolemodel-rails 2.6.1 → 2.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 54ba8996a84dfe7f2f989442444f039ebd5868a9a3f4800f800223d035f6a9d2
-  data.tar.gz: f79e30570b359cd0dc120b514127d207348589e85eb2f06414b0938aa3cd08d6
+  metadata.gz: b95ac3ec58a4a00a09e5777f82d033bedf584615a874de02f32cdfcc353ef5b7
+  data.tar.gz: 760c16f159ed100048c949bb01e94f5ac4d4a8e46a2aa3c2d64f5f30ff6ced93
 SHA512:
-  metadata.gz: 8b08a3d1b935ca08181f45fb948112194888325c6e60971c3c18b279b4cd8e9073dec7f01d8c26373bc9276e54b071c238fbece40ced0bb60da864f2c20b61c2
-  data.tar.gz: 96a5ea26590b5074da86fd3059ca6bb04e49bc3bd82fd4e2b56a3f18415dd80f2a807ef31ab396f6313034394d2e90e591eb75711a50f795744d00636ca2b298
+  metadata.gz: c72e0e6e196fb8e5b09447cb439126d4112f76746f4f1e017d858cfa93265f2c2131a8a81b35d4181e182f79dc4c1819c76e43a114253dacc43b0a729f96645f
+  data.tar.gz: 865f6f41f36e2060d4328ca7756a6688c8ed886d6db9a42ba1975a1c0d0f996a36857227ac862be7e780f1938af1c8d6e8094654009cd3306dbffe9427657b3e

data/README.md

@@ -110,6 +110,19 @@ bin/rails g
 * [Tom Select](./lib/generators/rolemodel/tom_select)
 * [Lograge](./lib/generators/rolemodel/lograge)
 
+## Agent Skills
+
+Generators that leave behind conventions a coding agent needs to follow also install the matching skill from [RoleModel/skills](https://github.com/RoleModel/skills) with [`npx skills`](https://github.com/vercel-labs/skills), without prompting. Skills land in `.agents/skills` (read by Copilot and Codex) and are symlinked into `.claude/skills`, and `skills-lock.json` records what was installed so `npx skills update` can refresh them. If you've picked agents in the skills CLI before, generators install for those agents instead of Claude Code, GitHub Copilot, and Codex.
+
+| Generator | Skill |
+|---|---|
+| `rolemodel:optics:base` | `optics-context` |
+| `rolemodel:testing:rspec` | `tdd` |
+| `rolemodel:turbo:modals` | `turbo-modals` |
+| `rolemodel:turbo:form` | `dynamic-forms` |
+| `rolemodel:soft_destroyable` | `soft-destroyable` |
+| `rolemodel:core_setup` | `polymorphic-parent-resources`, `rake-tasks` |
+
 ## Utilities
 
 ### `Rolemodel::Utility::TaskTools`

data/lib/generators/rolemodel/core_setup/README.md

@@ -1,5 +1,7 @@
 # Core Setup Generator
 
+[USAGE](./USAGE)
+
 Runs the core generators every new Rails app should have. Unlike
 `rolemodel:all`, this skips the app-specific extras (React, SaaS/Devise,
 GoodJob, Kaminari, etc.) so you get just the standard baseline — a new Rails
@@ -9,21 +11,28 @@ app you can push straight to Heroku right after generation.
 
   - A freshly generated Rails app
 
+## Options
+
+  - `--material`, `--phosphor`, `--tabler`, `--feather`, `--lucide`, or `--custom`
+    picks the Optics icon library up front. Without one, the icons generator asks.
+  - `--skip-deployable` skips Heroku, Sentry, and Lograge.
+
 ## What you get
 
-  - [GitHub](../github) — standard GitHub configuration
-  - [Heroku](../heroku) — standard Heroku deployment configuration
-  - [Readme](../readme) — standard project README
-  - [Webpack](../webpack) — Webpack v5 for JS and CSS
-  - [Sentry](../sentry) — error monitoring for Ruby and JavaScript
   - [Slim](../slim) — Slim templates
-  - [Optics](../optics) — Optics design system (pass an icon library flag such as
-    `--material` to choose it up front; otherwise the icons generator asks)
-  - [Testing](../testing) — RSpec, FactoryBot, parallel_tests, TestProf
-    (pass `--js-runner` to include jasmine-playwright-runner)
+  - [Webpack](../webpack) — Webpack v5 for JS and CSS
+  - [Optics](../optics) — Optics design system and icons
   - [SimpleForm](../simple_form) — SimpleForm with our configuration
   - [Tom Select](../tom_select) — Tom Select with a Stimulus controller and SimpleForm inputs
+  - [Testing](../testing) — RSpec, FactoryBot, parallel_tests, and TestProf
+  - [Turbo](../turbo) — Turbo 8 setup, confirm dialogs, modals, and dynamic forms
+  - [Flash](../ui_components/flash) — flash messages
+  - [GitHub](../github) — standard GitHub configuration
+  - [Readme](../readme) — standard project README
   - [Linters](../linters) — Rubocop and ESLint
-  - [UI Components](../ui_components) — flash, the modal pattern, & Turbo 8 support
-  - [Editors](../editors) — EditorConfig and recommended VSCode extensions
+  - [Heroku](../heroku) — standard Heroku deployment configuration
+  - [Sentry](../sentry) — error monitoring for Ruby and JavaScript
   - [Lograge](../lograge) — condensed request logging
+  - The [`polymorphic-parent-resources`](https://github.com/RoleModel/skills/tree/main/skills/polymorphic-parent-resources)
+    and [`rake-tasks`](https://github.com/RoleModel/skills/tree/main/skills/rake-tasks) agent skills for
+    `resource_for` and `Rolemodel::Utility::TaskTools`, installed into `.agents/skills`

data/lib/generators/rolemodel/core_setup/USAGE

@@ -1,12 +1,16 @@
 Description:
   Runs the core generators every new Rails app should have
 
-  Sets up GitHub config, Heroku deployment, README, Webpack, Sentry, Slim,
-  Optics, testing (RSpec & friends), SimpleForm, linters, Turbo 8+ support,
-  and Lograge. The result is an app that is ready to push directly to Heroku.
+  Sets up Slim, Webpack, Optics, SimpleForm, Tom Select, testing (RSpec &
+  friends), Turbo, flash messages, GitHub config, README, linters, Heroku
+  deployment, Sentry, and Lograge. It also installs the agent skills for
+  resource_for and TaskTools. The result is an app that is ready to push
+  directly to Heroku.
 
-  Pass --js-runner to also include jasmine-playwright-runner for browser
-  JS testing.
+  Pass an icon library flag (--material, --phosphor, --tabler, --feather,
+  --lucide, or --custom) to choose the Optics icons up front.
+
+  Pass --skip-deployable to skip Heroku, Sentry, and Lograge.
 
 Example:
-  rails generate rolemodel:core_setup
+  rails generate rolemodel:core_setup --material

data/lib/generators/rolemodel/core_setup/core_setup_generator.rb

@@ -6,6 +6,13 @@ module Rolemodel
 
     class_option :skip_deployable, type: :boolean, default: false, desc: 'skip generators for app deployment (Heroku, Sentry, Lograge)'
 
+    def install_agent_skills
+      say 'Installing agent skills for the rolemodel_rails utilities', :green
+
+      install_skill 'polymorphic-parent-resources'
+      install_skill 'rake-tasks'
+    end
+
     def run_the_core_generators
       generate 'rolemodel:slim'
       generate 'rolemodel:webpack'

data/lib/generators/rolemodel/optics/base/README.md

@@ -7,3 +7,5 @@ rails g rolemodel:optics:all
 ## What you get
 
 The [Optics](https://docs.optics.rolemodel.design/) design system
+
+Plus the [`optics-context`](https://github.com/RoleModel/skills/tree/main/skills/optics-context) agent skill, installed into `.agents/skills`

data/lib/generators/rolemodel/optics/base/base_generator.rb

@@ -16,6 +16,12 @@ module Rolemodel
           @import '@rolemodel/optics/dist/css/optics';
         CSS
       end
+
+      def install_agent_skill
+        say 'Installing the optics-context agent skill', :green
+
+        install_skill 'optics-context'
+      end
     end
   end
 end

data/lib/generators/rolemodel/soft_destroyable/README.md

@@ -4,5 +4,6 @@
 
 * Ruby module for SoftDestroyable
 * Shared example file for testing your classes
+* The [`soft-destroyable`](https://github.com/RoleModel/skills/tree/main/skills/soft-destroyable) agent skill, installed into `.agents/skills`
 
 Adds module for soft destroyable of ActiveRecord classes with configurable cascading of association data

data/lib/generators/rolemodel/soft_destroyable/soft_destroyable_generator.rb

@@ -9,5 +9,11 @@ module Rolemodel
     def add_shared_example
       copy_file 'soft_destroyable_behavior.rb', 'spec/support/shared_examples/soft_destroyable_behavior.rb'
     end
+
+    def install_agent_skill
+      say 'Installing the soft-destroyable agent skill', :green
+
+      install_skill 'soft-destroyable'
+    end
   end
 end

data/lib/generators/rolemodel/testing/rspec/README.md

@@ -2,6 +2,8 @@
 
 ## What you get
 
+* The [`tdd`](https://github.com/RoleModel/skills/tree/main/skills/tdd) agent skill, installed into `.agents/skills`
+
 ### RSpec Default
 
 Based of rspec-rails install generator. Assume all configuration will be placed in `spec/support/*.rb`

data/lib/generators/rolemodel/testing/rspec/rspec_generator.rb

@@ -39,6 +39,12 @@ module Rolemodel
 
         append_file '.gitignore', 'spec/examples.txt'
       end
+
+      def install_agent_skill
+        say 'Installing the tdd agent skill', :green
+
+        install_skill 'tdd'
+      end
     end
   end
 end

data/lib/generators/rolemodel/turbo/form/README.md

@@ -5,5 +5,6 @@ Enable dynamic form interactions in new/existing rails apps with the [turbo_form
 ## What you get
 
   - the `turbo_form` gem, set up by its `turbo_form:install` generator
+  - the [`dynamic-forms`](https://github.com/RoleModel/skills/tree/main/skills/dynamic-forms) agent skill, installed into `.agents/skills`
 
 Draw the `:turbo_form` route concern on each resource with a dynamic form. See the gem's README for usage.

data/lib/generators/rolemodel/turbo/form/form_generator.rb

@@ -8,6 +8,12 @@ module Rolemodel
 
         generate 'turbo_form:install'
       end
+
+      def install_agent_skill
+        say 'Installing the dynamic-forms agent skill', :green
+
+        install_skill 'dynamic-forms'
+      end
     end
   end
 end

data/lib/generators/rolemodel/turbo/modals/README.md

@@ -11,6 +11,7 @@
 
 * RoleModel Modal pattern integration. See Notes below for usage documentation.
 * RoleModel Panel pattern integration, if run with the `--panels` flag.
+* The [`turbo-modals`](https://github.com/RoleModel/skills/tree/main/skills/turbo-modals) agent skill, installed into `.agents/skills`
 
 > [!IMPORTANT]
 > This generator does not provide RoleModel Panel integration, unless run with the `--panels` flag.

data/lib/generators/rolemodel/turbo/modals/modals_generator.rb

@@ -55,7 +55,12 @@ module Rolemodel
 
         rails_command 'stimulus:manifest:update'
       end
+
+      def install_agent_skill
+        say 'Installing the turbo-modals agent skill', :green
+
+        install_skill 'turbo-modals'
+      end
     end
   end
 end
-

data/lib/generators/rolemodel/ui_components/README.md

@@ -5,5 +5,6 @@
 ## What you get
 
 * [Flash](./flash)
-* [Modals](./modals)
 * [Navbar](./navbar)
+
+Modals moved to the [Turbo modals](../turbo/modals) generator.

data/lib/rolemodel/generator_base.rb

@@ -3,11 +3,12 @@
 require 'rails/generators'
 require 'rails/generators/bundle_helper'
 require_relative 'replace_content_helper'
+require_relative 'skills_helper'
 require 'rolemodel/yarn'
 
 module Rolemodel
   class GeneratorBase < ::Rails::Generators::Base
-    include ::Rails::Generators::BundleHelper, ReplaceContentHelper
+    include ::Rails::Generators::BundleHelper, ReplaceContentHelper, SkillsHelper
 
     private
 

data/lib/rolemodel/skills_helper.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'json'
+
+module Rolemodel
+  module SkillsHelper
+    SKILLS_REPO = 'RoleModel/skills'
+    DEFAULT_SKILL_AGENTS = %w[claude-code github-copilot codex].freeze
+
+    private
+
+    def install_skill(name)
+      inside('.') { run "npx -y skills@latest add #{SKILLS_REPO} --skill #{name} --agent #{skill_agents.join(' ')} -y" }
+    end
+
+    # Agents the user last picked in the skills CLI; it only offers them as defaults interactively.
+    def skill_agents
+      JSON.parse(File.read(skills_state_path))['lastSelectedAgents'].presence || DEFAULT_SKILL_AGENTS
+    rescue Errno::ENOENT, JSON::ParserError
+      DEFAULT_SKILL_AGENTS
+    end
+
+    def skills_state_path
+      state_home = ENV['XDG_STATE_HOME']
+      state_home ? File.join(state_home, 'skills/.skill-lock.json') : File.expand_path('~/.agents/.skill-lock.json')
+    end
+  end
+end

data/lib/rolemodel/utility/task_tools.rb

@@ -62,7 +62,7 @@ module Rolemodel
       end
 
       def to_h
-        @args.transform_values { it.to_s.strip.match?('_') ? nil : it.to_s.strip }.compact
+        @args.transform_values { it.to_s.strip.presence unless it.to_s.strip == '_' }.compact
       end
     end
   end

data/lib/rolemodel/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Rolemodel
-  VERSION = '2.6.1'
+  VERSION = '2.7.1'
 end

data/lib/rolemodel-rails.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Rolemodel
-  NODE_VERSION = '24.12.0'
+  NODE_VERSION = '26.13.0'
 
   GEM_LIB = File.expand_path(__dir__)
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rolemodel-rails
 version: !ruby/object:Gem::Version
-  version: 2.6.1
+  version: 2.7.1
 platform: ruby
 authors:
 - RoleModel Software Inc
@@ -460,6 +460,7 @@ files:
 - lib/rolemodel/optics/tabler_icon_builder.rb
 - lib/rolemodel/replace_content_helper.rb
 - lib/rolemodel/resource_for/controller_extension.rb
+- lib/rolemodel/skills_helper.rb
 - lib/rolemodel/utility.rb
 - lib/rolemodel/utility/task_tools.rb
 - lib/rolemodel/version.rb