plutonium 0.45.2 → 0.46.0

data/.claude/skills/plutonium-definition-query/SKILL.md

@@ -1,364 +0,0 @@
----
-name: plutonium-definition-query
-description: Use when adding search, filters, named scopes, or sorting to a Plutonium resource definition
----
-
-# Definition Query
-
-Configure how users can search, filter, and sort resource collections.
-
-## Overview
-
-```ruby
-class PostDefinition < ResourceDefinition
-  # Search - global text search
-  search do |scope, query|
-    scope.where("title ILIKE ?", "%#{query}%")
-  end
-
-  # Filters - dropdown filter panel
-  filter :title, with: :text, predicate: :contains
-  filter :status, with: :select, choices: %w[draft published archived]
-  filter :published, with: :boolean
-  filter :created_at, with: :date_range
-  filter :category, with: :association
-
-  # Scopes - quick filter buttons
-  scope :published
-  scope :draft
-
-  # Default scope
-  default_scope :published
-
-  # Sorting - sortable columns
-  sort :title
-  sort :created_at
-
-  # Default sort
-  default_sort :created_at, :desc
-end
-```
-
-## Search
-
-Define global search across fields:
-
-```ruby
-# Single field
-search do |scope, query|
-  scope.where("title ILIKE ?", "%#{query}%")
-end
-
-# Multiple fields
-search do |scope, query|
-  scope.where(
-    "title ILIKE :q OR content ILIKE :q OR author_name ILIKE :q",
-    q: "%#{query}%"
-  )
-end
-
-# With associations
-search do |scope, query|
-  scope.joins(:author).where(
-    "posts.title ILIKE :q OR users.name ILIKE :q",
-    q: "%#{query}%"
-  ).distinct
-end
-
-# Split search terms
-search do |scope, query|
-  terms = query.split(/\s+/)
-  terms.reduce(scope) do |current_scope, term|
-    current_scope.where("title ILIKE ?", "%#{term}%")
-  end
-end
-```
-
-## Filters
-
-Plutonium provides **6 built-in filter types**. Use shorthand symbols or full class names.
-
-### Text Filter
-
-String/text filtering with pattern matching.
-
-```ruby
-# Shorthand (recommended)
-filter :title, with: :text, predicate: :contains
-filter :status, with: :text, predicate: :eq
-
-# Full class name
-filter :title, with: Plutonium::Query::Filters::Text, predicate: :contains
-```
-
-**Predicates:**
-
-| Predicate | SQL | Description |
-|-----------|-----|-------------|
-| `:eq` | `= value` | Exact match (default) |
-| `:not_eq` | `!= value` | Not equal |
-| `:contains` | `LIKE %value%` | Contains substring |
-| `:not_contains` | `NOT LIKE %value%` | Does not contain |
-| `:starts_with` | `LIKE value%` | Starts with |
-| `:ends_with` | `LIKE %value` | Ends with |
-| `:matches` | `LIKE value` | Pattern match (`*` becomes `%`) |
-| `:not_matches` | `NOT LIKE value` | Does not match pattern |
-
-### Boolean Filter
-
-True/false filtering for boolean columns.
-
-```ruby
-# Basic
-filter :active, with: :boolean
-
-# Custom labels
-filter :published, with: :boolean, true_label: "Published", false_label: "Draft"
-```
-
-Renders a select dropdown with "All", true label ("Yes"), and false label ("No").
-
-### Date Filter
-
-Single date filtering with comparison predicates.
-
-```ruby
-filter :created_at, with: :date, predicate: :gteq  # On or after
-filter :due_date, with: :date, predicate: :lt      # Before
-filter :published_at, with: :date, predicate: :eq  # On exact date
-```
-
-**Predicates:**
-
-| Predicate | Description |
-|-----------|-------------|
-| `:eq` | On this date (default) |
-| `:not_eq` | Not on this date |
-| `:lt` | Before date |
-| `:lteq` | On or before date |
-| `:gt` | After date |
-| `:gteq` | On or after date |
-
-### Date Range Filter
-
-Filter between two dates (from/to).
-
-```ruby
-# Basic
-filter :created_at, with: :date_range
-
-# Custom labels
-filter :published_at, with: :date_range,
-  from_label: "Published from",
-  to_label: "Published to"
-```
-
-Renders two date pickers. Both are optional - users can filter with just "from" or just "to".
-
-### Select Filter
-
-Filter from predefined choices.
-
-```ruby
-# Static choices (array)
-filter :status, with: :select, choices: %w[draft published archived]
-
-# Dynamic choices (proc)
-filter :category, with: :select, choices: -> { Category.pluck(:name) }
-
-# Multiple selection
-filter :tags, with: :select, choices: %w[ruby rails js], multiple: true
-```
-
-### Association Filter
-
-Filter by associated record.
-
-```ruby
-# Basic - infers Category class from :category key
-filter :category, with: :association
-
-# Explicit class
-filter :author, with: :association, class_name: User
-
-# Multiple selection
-filter :tags, with: :association, class_name: Tag, multiple: true
-```
-
-Renders a resource select dropdown. Converts filter key to foreign key (`:category` -> `:category_id`).
-
-## Custom Filters
-
-### Custom Filter Class
-
-```ruby
-class PriceRangeFilter < Plutonium::Query::Filter
-  def apply(scope, min: nil, max: nil)
-    scope = scope.where("price >= ?", min) if min.present?
-    scope = scope.where("price <= ?", max) if max.present?
-    scope
-  end
-
-  def customize_inputs
-    input :min, as: :number
-    input :max, as: :number
-    field :min, placeholder: "Min price..."
-    field :max, placeholder: "Max price..."
-  end
-end
-
-# Use in definition
-filter :price, with: PriceRangeFilter
-```
-
-## Scopes
-
-Scopes appear as quick filter buttons. They reference model scopes.
-
-### Basic Usage
-
-```ruby
-class PostDefinition < ResourceDefinition
-  scope :published    # Uses Post.published
-  scope :draft        # Uses Post.draft
-  scope :featured     # Uses Post.featured
-end
-```
-
-### Inline Scope
-
-Use block syntax with the scope passed as an argument:
-
-```ruby
-scope(:recent) { |scope| scope.where('created_at > ?', 1.week.ago) }
-scope(:this_month) { |scope| scope.where(created_at: Time.current.all_month) }
-```
-
-### With Controller Context
-
-Inline scopes have access to controller context like `current_user`:
-
-```ruby
-scope(:mine) { |scope| scope.where(author: current_user) }
-scope(:my_team) { |scope| scope.where(team: current_user.team) }
-```
-
-### Default Scope
-
-Set a scope as default to apply it when no scope is explicitly selected:
-
-```ruby
-class PostDefinition < ResourceDefinition
-  scope :published
-  scope :draft
-  scope :archived
-
-  default_scope :published  # Applied by default
-end
-```
-
-When a default scope is set:
-- The default scope is applied on initial page load
-- The default scope button is highlighted (not "All")
-- Clicking "All" shows all records without any scope filter
-- URL without scope param uses the default; URL with `?q[scope]=` uses "All"
-
-## Sorting
-
-### Basic Sorting
-
-```ruby
-sort :title
-sort :created_at
-sort :view_count
-
-# Multiple at once
-sorts :title, :created_at, :view_count
-```
-
-### Default Sort
-
-```ruby
-# Field and direction
-default_sort :created_at, :desc
-default_sort :title, :asc
-
-# Complex sorting with block
-default_sort { |scope| scope.order(featured: :desc, created_at: :desc) }
-```
-
-**Note:** Default sort only applies when no sort params are provided.
-
-## URL Parameters
-
-Query parameters are structured under `q`:
-
-```
-/posts?q[search]=rails
-/posts?q[title][query]=widget
-/posts?q[status][value]=published
-/posts?q[created_at][from]=2024-01-01&q[created_at][to]=2024-12-31
-/posts?q[scope]=recent
-/posts?q[sort_fields][]=created_at&q[sort_directions][created_at]=desc
-```
-
-## Filter Summary Table
-
-| Type | Symbol | Input Params | Options |
-|------|--------|--------------|---------|
-| Text | `:text` | `query` | `predicate:` |
-| Boolean | `:boolean` | `value` | `true_label:`, `false_label:` |
-| Date | `:date` | `value` | `predicate:` |
-| Date Range | `:date_range` | `from`, `to` | `from_label:`, `to_label:` |
-| Select | `:select` | `value` | `choices:`, `multiple:` |
-| Association | `:association` | `value` | `class_name:`, `multiple:` |
-
-## Complete Example
-
-```ruby
-class ProductDefinition < ResourceDefinition
-  # Full-text search
-  search do |scope, query|
-    scope.where(
-      "name ILIKE :q OR description ILIKE :q",
-      q: "%#{query}%"
-    )
-  end
-
-  # Filters
-  filter :name, with: :text, predicate: :contains
-  filter :status, with: :select, choices: %w[draft active discontinued]
-  filter :featured, with: :boolean
-  filter :created_at, with: :date_range
-  filter :price, with: :date, predicate: :gteq
-  filter :category, with: :association
-
-  # Quick scopes
-  scope :active
-  scope :featured
-  scope(:recent) { |scope| scope.where('created_at > ?', 1.week.ago) }
-
-  # Default scope
-  default_scope :active
-
-  # Sortable columns
-  sorts :name, :price, :created_at
-
-  # Default sort
-  default_sort :created_at, :desc
-end
-```
-
-## Performance Tips
-
-1. **Add indexes** for filtered/sorted columns
-2. **Use `.distinct`** when joining associations in search
-3. **Consider `pg_search`** for complex full-text search
-4. **Limit search fields** to indexed columns
-5. **Use scopes** instead of filters for common queries
-
-## Related Skills
-
-- `plutonium-definition` - Overview and structure
-- `plutonium-definition` - Fields, inputs, displays
-- `plutonium-definition-actions` - Actions and interactions

data/.claude/skills/plutonium-profile/SKILL.md

@@ -1,276 +0,0 @@
----
-name: plutonium-profile
-description: Use when adding a user profile or account settings page with Rodauth security features
----
-
-# Plutonium User Profile
-
-Plutonium provides a Profile resource generator for managing Rodauth account settings. The profile resource allows users to:
-- View and edit their profile information
-- Access Rodauth security features (change password, 2FA, etc.)
-- Manage their account settings in one place
-
-## Quick Setup
-
-Use the setup generator to create and connect the profile in one command:
-
-```bash
-rails g pu:profile:setup date_of_birth:date bio:text \
-    --dest=competition \
-    --portal=competition_portal
-```
-
-## Step-by-Step Installation
-
-### Install the Profile Resource
-
-```bash
-rails generate pu:profile:install --dest=main_app
-```
-
-**Options:**
-
-| Option | Default | Description |
-|--------|---------|-------------|
-| `--dest=DESTINATION` | (prompts) | Target package or main_app |
-| `--user-model=NAME` | User | Rodauth user model name |
-
-**With custom fields:**
-
-```bash
-rails g pu:profile:install \
-    bio:text \
-    avatar:attachment \
-    'timezone:string?' \
-    --dest=customer
-```
-
-**With custom name:**
-
-```bash
-rails g pu:profile:install AccountSettings \
-    bio:text \
-    --dest=main_app
-```
-
-## What Gets Created
-
-The generator creates a standard Plutonium resource:
-
-```
-app/models/[package/]profile.rb              # Profile model
-db/migrate/xxx_create_profiles.rb            # Migration
-app/controllers/[package/]profiles_controller.rb
-app/policies/[package/]profile_policy.rb
-app/definitions/[package/]profile_definition.rb
-```
-
-And modifies:
-- **User model**: Adds `has_one :profile, dependent: :destroy`
-- **Definition**: Injects custom ShowPage with SecuritySection
-
-## The SecuritySection Component
-
-The generator injects a custom `ShowPage` that renders `Plutonium::Profile::SecuritySection`:
-
-```ruby
-class ProfileDefinition < Plutonium::Resource::Definition
-  class ShowPage < ShowPage
-    private
-
-    def render_after_content
-      render Plutonium::Profile::SecuritySection.new
-    end
-  end
-end
-```
-
-The `SecuritySection` component dynamically checks which Rodauth features are enabled and displays links for:
-
-| Feature | Label | Description |
-|---------|-------|-------------|
-| `change_password` | Change Password | Update account password |
-| `change_login` | Change Email | Update email address |
-| `otp` | Two-Factor Authentication | Set up TOTP |
-| `recovery_codes` | Recovery Codes | View/regenerate backup codes |
-| `webauthn` | Security Keys | Manage passkeys |
-| `active_sessions` | Active Sessions | View/manage sessions |
-| `close_account` | Close Account | Delete account |
-
-Only enabled Rodauth features are displayed.
-
-## After Generation
-
-### 1. Run Migrations
-
-```bash
-rails db:migrate
-```
-
-### 2. Connect to Portal
-
-Use the profile connect generator to register as a singular resource and configure the `profile_url` helper:
-
-```bash
-rails g pu:profile:conn --dest=customer_portal
-```
-
-This:
-- Registers the Profile as a singular resource (`/profile` instead of `/profiles/:id`)
-- Adds `profile_url` helper to enable the "Profile" link in the user menu
-
-### 3. Create Profile Automatically
-
-Users need a profile created. Add a callback or use `find_or_create`:
-
-```ruby
-# Option A: Callback on User
-class User < ApplicationRecord
-  after_create :create_profile!
-
-  private
-
-  def create_profile!
-    create_profile
-  end
-end
-
-# Option B: In controller or before_action
-def current_profile
-  @current_profile ||= current_user.profile || current_user.create_profile
-end
-```
-
-## Customization
-
-### Adding Profile Fields
-
-Add fields during generation:
-
-```bash
-rails g pu:profile:install \
-    bio:text \
-    avatar:attachment \
-    website:string \
-    'company:string?' \
-    --dest=main_app
-```
-
-Or add to the migration manually before running.
-
-### Customizing the Definition
-
-Edit the generated definition:
-
-```ruby
-# app/definitions/profile_definition.rb
-class ProfileDefinition < Plutonium::Resource::Definition
-  # Form configuration
-  form do |f|
-    f.field :bio
-    f.field :avatar
-    f.field :website
-  end
-
-  # Display configuration
-  display do |d|
-    d.field :bio
-    d.field :avatar
-    d.field :website
-  end
-
-  class ShowPage < ShowPage
-    private
-
-    def render_after_content
-      render Plutonium::Profile::SecuritySection.new
-    end
-  end
-end
-```
-
-### Custom Security Section
-
-Override the SecuritySection or create your own:
-
-```ruby
-class ProfileDefinition < Plutonium::Resource::Definition
-  class ShowPage < ShowPage
-    private
-
-    def render_after_content
-      render CustomSecuritySection.new
-    end
-  end
-end
-```
-
-### Adding Custom Actions
-
-Add profile-specific actions:
-
-```ruby
-class ProfileDefinition < Plutonium::Resource::Definition
-  action :export_data,
-    interaction: Profile::ExportDataInteraction
-
-  action :verify_email,
-    interaction: Profile::VerifyEmailInteraction,
-    category: :secondary
-end
-```
-
-## Profile Link in Header
-
-To add a profile link to the resource header, the `profile_url` helper is available via `Plutonium::Auth::Rodauth`:
-
-```ruby
-# In your controller or view
-if respond_to?(:profile_url)
-  link_to "Profile", profile_url
-end
-```
-
-This helper is automatically available when Profile is connected to a portal.
-
-## Troubleshooting
-
-### "User model not found"
-
-Ensure the User model exists at `app/models/user.rb` with the marker comment:
-
-```ruby
-class User < ApplicationRecord
-  # add has_one associations above.
-end
-```
-
-### "Definition path not found"
-
-If using a package destination, ensure the package exists:
-
-```bash
-# Check available packages
-ls packages/
-```
-
-### Profile Not Loading
-
-Ensure the Profile is connected to your portal:
-
-```bash
-rails g pu:res:conn Profile --dest=my_portal --singular
-```
-
-And the user has a profile:
-
-```ruby
-current_user.profile || current_user.create_profile
-```
-
-## Related Skills
-
-- `plutonium-rodauth` - Authentication configuration
-- `plutonium-definition` - Customizing the profile definition
-- `plutonium-views` - Custom pages and components
-- `plutonium-portal` - Connecting resources to portals