plutonium 0.44.1 → 0.45.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 39e28c885ee021fd3d43a18a3df18a3dc0b72e0d14df80752aabf07794fa3e9e
-  data.tar.gz: 07b0e596884dfa08ed83c7f09702a4a068dcb4442f478ac5d4a254cada100f07
+  metadata.gz: 1073fa6b607e230a752fac717f223a0b641179b3c2b93b67d941d40b6dea07e2
+  data.tar.gz: 28da869f69c58a437c102be436ddb31f4017795dba17b244a8f2db15a15c7bea
 SHA512:
-  metadata.gz: 7328f0c85782184f85b787c7e0c0614e03d57be0c558891da80ac96d1a0fc8371e41ec3ddf16e69c96a4f233859862454942912f1790efb62d240d7cb4a42549
-  data.tar.gz: 5d4344102ccedc91fc38295d3d2900b86536aa1cacebf47297e4ba469a7eb677cad092bba42daf7d74b09de7772e768380563e23dc5b1ad8633089b8698b4058
+  metadata.gz: 11b347e6f98eaeb7a3cc93c75d3c67483107ddc3d822780ce9bcb12901af3b3d9c7fe7996b7bacffc3ea32528ebbab5a9affb54d9bfb56dbeec49cb40da92f46
+  data.tar.gz: 5c0a5d6f4988980b8195cdd4d27d1c28189a8cc6d34c889136b73f512f6cd88ecaf2851af52ef666e68f1c5b66802fac570831ce6608c195d707871b5b35d899

data/.claude/skills/plutonium/skill.md

@@ -1,6 +1,6 @@
 ---
 name: plutonium
-description: High-level guide for working with Plutonium applications - read this first
+description: Use when starting work on a Plutonium app, unsure which skill to read, or need an overview of the resource architecture
 ---
 
 # Plutonium Development Guide
@@ -20,29 +20,101 @@ Read this first when working on a Plutonium application.
 rails g pu:res:scaffold Post title:string --dest=main_app    # Create resource
 rails g pu:res:conn Post --dest=admin_portal                 # Connect to portal
 rails g pu:pkg:package blogging                              # Create feature package
-rails g pu:pkg:portal admin_portal                           # Create portal
+rails g pu:pkg:portal admin                                  # Create portal
 ```
 
 Always specify `--dest` to avoid interactive prompts.
 
 ## Resource Architecture
 
-A resource has four layers:
+A **resource** is four layers working together for full CRUD with minimal code:
 
-| Layer | Purpose | Customize when... |
-|-------|---------|-------------------|
-| Model | Data, validations, associations | Adding business logic |
-| Definition | UI - fields, actions, filters | Changing how things look/behave |
-| Policy | Authorization - who can do what | Restricting access |
-| Controller | Request handling | Rarely - use hooks if needed |
+| Layer | File | Purpose | Customize when... |
+|-------|------|---------|-------------------|
+| **Model** | `app/models/post.rb` | Data, validations, associations | Adding business logic |
+| **Definition** | `app/definitions/post_definition.rb` | UI - fields, actions, filters | Changing how things look/behave |
+| **Policy** | `app/policies/post_policy.rb` | Authorization - who can do what | Restricting access |
+| **Controller** | `app/controllers/posts_controller.rb` | Request handling | Rarely - use hooks if needed |
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                           Resource                              │
+├─────────────────────────────────────────────────────────────────┤
+│  Model          │  Definition      │  Policy        │ Controller│
+│  (WHAT it is)   │  (HOW it looks)  │  (WHO can act) │ (HOW it   │
+│                 │                  │                │  responds) │
+├─────────────────────────────────────────────────────────────────┤
+│  - attributes   │  - field types   │  - permissions │ - CRUD    │
+│  - associations │  - inputs/forms  │  - scoping     │ - redirects│
+│  - validations  │  - displays      │  - attributes  │ - params  │
+│  - scopes       │  - actions       │                │           │
+│  - callbacks    │  - filters       │                │           │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## Auto-Detection
+
+Plutonium automatically detects from your model:
+- All database columns with appropriate field types
+- Associations (belongs_to, has_one, has_many)
+- Attachments (Active Storage)
+- Enums
+
+**You only need to declare when overriding defaults.**
+
+## Creating Resources
+
+### New Resources (from scratch)
+
+```bash
+rails g pu:res:scaffold Post user:belongs_to title:string 'content:text?' published:boolean --dest=main_app
+```
+
+See `plutonium-create-resource` skill for full generator options.
+
+### From Existing Models
+
+1. Include `Plutonium::Resource::Record` in your model (or inherit from a class that does)
+2. Generate supporting files: `rails g pu:res:scaffold Post --no-migration`
+3. Connect to a portal: `rails g pu:res:conn Post --dest=admin_portal`
+
+## Connecting to Portals
+
+Resources must be connected to a portal to be accessible:
+
+```bash
+rails g pu:res:conn Post --dest=admin_portal
+```
+
+See `plutonium-portal` skill for portal details.
+
+## Portal-Specific Customization
+
+Each portal can override the base definition, policy, and controller:
+
+```ruby
+# Admin portal sees more
+class AdminPortal::PostDefinition < ::PostDefinition
+  scope :draft
+  scope :pending_review
+  action :feature, interaction: FeaturePostInteraction
+end
+```
+
+## Workflow Summary
+
+1. **Generate** - `rails g pu:res:scaffold Model attributes... --dest=main_app`
+2. **Migrate** - `rails db:migrate`
+3. **Connect** - `rails g pu:res:conn Model --dest=portal_name`
+4. **Customize** - Edit definition/policy as needed
 
 ## Skill Reference
 
 | Topic | Skill |
 |-------|-------|
 | Creating resources | `plutonium-create-resource` |
-| Connecting to portals | `plutonium-connect-resource` |
-| Field configuration | `plutonium-definition-fields` |
+| Models & features | `plutonium-model` |
+| Field configuration | `plutonium-definition` |
 | Actions & interactions | `plutonium-definition-actions` |
 | Search, filters, scopes | `plutonium-definition-query` |
 | Authorization | `plutonium-policy` |
@@ -51,3 +123,8 @@ A resource has four layers:
 | Nested resources | `plutonium-nested-resources` |
 | Packages & portals | `plutonium-package`, `plutonium-portal` |
 | Authentication | `plutonium-rodauth` |
+| Interactions | `plutonium-interaction` |
+| Theming & assets | `plutonium-theming`, `plutonium-assets` |
+| User profile | `plutonium-profile` |
+| User invites | `plutonium-invites` |
+| Installation | `plutonium-installation` |

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

@@ -1,6 +1,6 @@
 ---
 name: plutonium-assets
-description: Plutonium asset setup - TailwindCSS configuration, Stimulus controllers, and Phlexi component themes
+description: Use when setting up TailwindCSS, registering Stimulus controllers, or theming Phlexi components in a Plutonium app
 ---
 
 # Plutonium Assets & Setup

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

@@ -1,10 +1,14 @@
 ---
 name: plutonium-controller
-description: Plutonium resource controllers - CRUD actions, customization, and integration
+description: Use when customizing controller behavior, overriding CRUD actions, adding hooks, or changing redirect logic in Plutonium
 ---
 
 # Plutonium Controllers
 
+**Controllers are generated automatically** - never create them manually:
+- `rails g pu:res:scaffold` creates the base controller
+- `rails g pu:res:conn` creates portal-specific controllers
+
 Controllers in Plutonium provide full CRUD functionality out of the box. You rarely need to customize them - definitions handle most UI configuration and policies handle authorization.
 
 ## Base Classes
@@ -377,7 +381,7 @@ end
 
 ## Related Skills
 
-- `plutonium-resource` - How controllers fit in the resource architecture
+- `plutonium` - How controllers fit in the resource architecture
 - `plutonium-policy` - Authorization (used by controllers)
 - `plutonium-definition-actions` - Interactive actions (preferred over custom controller actions)
 - `plutonium-views` - Custom page, form, display, and table classes

data/.claude/skills/plutonium-create-resource/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: plutonium-create-resource
-description: Generate Plutonium resources with models, migrations, controllers, policies, and definitions
+description: Use when creating a new Plutonium resource - covers the pu:res:scaffold generator, field type syntax, and generator options
 ---
 
 # Create Resource Skill