plutonium 0.60.5 → 0.62.0

data/app/views/layouts/basic.html.erb

@@ -0,0 +1,7 @@
+<%= render Plutonium::UI::Layout::BasicLayout.new do |layout| %>
+  <%# Shell-less wizards have no topbar, so lift the content off the viewport edge %>
+  <%# and cap its width — keeping it comfortably centered like an onboarding screen. %>
+  <div class="mx-auto w-full max-w-3xl pt-8 sm:pt-14">
+    <%= yield %>
+  </div>
+<% end %>

data/app/views/plutonium/_flash_toasts.html.erb

@@ -1,48 +1,4 @@
 <% flash.each do |type, msg| %>
-<%
-  next unless msg.present?
-
-  variant = {
-    success: "success",
-    warning: "warning",
-    alert: "danger", danger: "danger", error: "danger"
-  }.fetch(type.to_sym, "info")
-%>
-
-<div data-controller="resource-dismiss"
-    data-resource-dismiss-after-value="6000"
-    class="pu-toast pu-toast-<%= variant %>"
-    role="alert">
-
-  <div class="pu-toast-icon">
-    <% case type.to_sym %>
-    <% when :success %>
-      <svg class="w-5 h-5" aria-hidden="true" xmlns="http://www.w3.org/2000/svg" fill="currentColor" viewBox="0 0 20 20">
-        <path d="M10 .5a9.5 9.5 0 1 0 9.5 9.5A9.51 9.51 0 0 0 10 .5Zm3.707 8.207-4 4a1 1 0 0 1-1.414 0l-2-2a1 1 0 0 1 1.414-1.414L9 10.586l3.293-3.293a1 1 0 0 1 1.414 1.414Z"/>
-      </svg>
-    <% when :warning %>
-      <svg class="w-5 h-5" aria-hidden="true" xmlns="http://www.w3.org/2000/svg" fill="currentColor" viewBox="0 0 20 20">
-        <path d="M10 .5a9.5 9.5 0 1 0 9.5 9.5A9.51 9.51 0 0 0 10 .5ZM10 15a1 1 0 1 1 0-2 1 1 0 0 1 0 2Zm1-4a1 1 0 0 1-2 0V6a1 1 0 0 1 2 0v5Z"/>
-      </svg>
-    <% when :alert, :danger, :error %>
-      <svg class="w-5 h-5" aria-hidden="true" xmlns="http://www.w3.org/2000/svg" fill="currentColor" viewBox="0 0 20 20">
-        <path d="M10 .5a9.5 9.5 0 1 0 9.5 9.5A9.51 9.51 0 0 0 10 .5Zm3.707 11.793a1 1 0 1 1-1.414 1.414L10 11.414l-2.293 2.293a1 1 0 0 1-1.414-1.414L8.586 10 6.293 7.707a1 1 0 0 1 1.414-1.414L10 8.586l2.293-2.293a1 1 0 0 1 1.414 1.414L11.414 10l2.293 2.293Z"/>
-      </svg>
-    <% else %>
-      <svg class="w-4 h-4" aria-hidden="true" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 18 20">
-        <path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15.147 15.085a7.159 7.159 0 0 1-6.189 3.307A6.713 6.713 0 0 1 3.1 15.444c-2.679-4.513.287-8.737.888-9.548A4.373 4.373 0 0 0 5 1.608c1.287.953 6.445 3.218 5.537 10.5 1.5-1.122 2.706-3.01 2.853-6.14 1.433 1.049 3.993 5.395 1.757 9.117Z"/>
-      </svg>
-    <% end %>
-  </div>
-  <div class="pu-toast-message"><%= msg %></div>
-  <button type="button"
-    class="pu-toast-close"
-    data-action="click->resource-dismiss#dismiss"
-    aria-label="Close">
-      <span class="sr-only">Close</span>
-      <svg class="w-3 h-3" aria-hidden="true" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 14 14">
-          <path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="m1 1 6 6m0 0 6 6M7 7l6-6M7 7l-6 6"/>
-      </svg>
-  </button>
-</div>
+  <% next unless msg.present? %>
+  <%= render "plutonium/toast", type: type, msg: msg %>
 <% end %>

data/app/views/plutonium/_toast.html.erb

@@ -0,0 +1,52 @@
+<%#
+  Renders a single dismissable toast. Locals:
+    type — flash-style key (:success, :warning, :alert/:danger/:error, …)
+    msg  — the message string
+  Shared by _flash_toasts (one per flash entry) and any turbo_stream that
+  wants to append a single toast without re-rendering the whole flash set
+  (e.g. the kanban move-rejection feedback).
+%>
+<%
+  variant = {
+    success: "success",
+    warning: "warning",
+    alert: "danger", danger: "danger", error: "danger"
+  }.fetch(type.to_sym, "info")
+%>
+
+<div data-controller="resource-dismiss"
+    data-resource-dismiss-after-value="6000"
+    class="pu-toast pu-toast-<%= variant %>"
+    role="alert">
+
+  <div class="pu-toast-icon">
+    <% case type.to_sym %>
+    <% when :success %>
+      <svg class="w-5 h-5" aria-hidden="true" xmlns="http://www.w3.org/2000/svg" fill="currentColor" viewBox="0 0 20 20">
+        <path d="M10 .5a9.5 9.5 0 1 0 9.5 9.5A9.51 9.51 0 0 0 10 .5Zm3.707 8.207-4 4a1 1 0 0 1-1.414 0l-2-2a1 1 0 0 1 1.414-1.414L9 10.586l3.293-3.293a1 1 0 0 1 1.414 1.414Z"/>
+      </svg>
+    <% when :warning %>
+      <svg class="w-5 h-5" aria-hidden="true" xmlns="http://www.w3.org/2000/svg" fill="currentColor" viewBox="0 0 20 20">
+        <path d="M10 .5a9.5 9.5 0 1 0 9.5 9.5A9.51 9.51 0 0 0 10 .5ZM10 15a1 1 0 1 1 0-2 1 1 0 0 1 0 2Zm1-4a1 1 0 0 1-2 0V6a1 1 0 0 1 2 0v5Z"/>
+      </svg>
+    <% when :alert, :danger, :error %>
+      <svg class="w-5 h-5" aria-hidden="true" xmlns="http://www.w3.org/2000/svg" fill="currentColor" viewBox="0 0 20 20">
+        <path d="M10 .5a9.5 9.5 0 1 0 9.5 9.5A9.51 9.51 0 0 0 10 .5Zm3.707 11.793a1 1 0 1 1-1.414 1.414L10 11.414l-2.293 2.293a1 1 0 0 1-1.414-1.414L8.586 10 6.293 7.707a1 1 0 0 1 1.414-1.414L10 8.586l2.293-2.293a1 1 0 0 1 1.414 1.414L11.414 10l2.293 2.293Z"/>
+      </svg>
+    <% else %>
+      <svg class="w-4 h-4" aria-hidden="true" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 18 20">
+        <path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15.147 15.085a7.159 7.159 0 0 1-6.189 3.307A6.713 6.713 0 0 1 3.1 15.444c-2.679-4.513.287-8.737.888-9.548A4.373 4.373 0 0 0 5 1.608c1.287.953 6.445 3.218 5.537 10.5 1.5-1.122 2.706-3.01 2.853-6.14 1.433 1.049 3.993 5.395 1.757 9.117Z"/>
+      </svg>
+    <% end %>
+  </div>
+  <div class="pu-toast-message"><%= msg %></div>
+  <button type="button"
+    class="pu-toast-close"
+    data-action="click->resource-dismiss#dismiss"
+    aria-label="Close">
+      <span class="sr-only">Close</span>
+      <svg class="w-3 h-3" aria-hidden="true" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 14 14">
+          <path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="m1 1 6 6m0 0 6 6M7 7l6-6M7 7l-6 6"/>
+      </svg>
+  </button>
+</div>

data/app/views/resource/_kanban_move_action_form.html.erb

@@ -0,0 +1 @@
+<%= render Plutonium::UI::Form::KanbanMove.new(@interaction) %>

data/app/views/resource/_resource_kanban.html.erb

@@ -0,0 +1 @@
+<%= render build_kanban_board_shell %>

data/app/views/resource/kanban_move_form.html.erb

@@ -0,0 +1 @@
+<%= render Plutonium::UI::Page::KanbanMove.new %>

data/config/brakeman.ignore

@@ -144,11 +144,11 @@
     {
       "warning_type": "Dangerous Eval",
       "warning_code": 13,
-      "fingerprint": "ac51d516bdbc88a0a624795dad1b3efc1d2744b3f2d7be7feb67e0b5cebab763",
+      "fingerprint": "bdacd028907815ba0db0cf99e069d1ea7e94a6e527b7746efd97886c52b2f928",
       "check_name": "Evaluation",
       "message": "Dynamic string evaluated as code",
       "file": "lib/plutonium/models/has_cents.rb",
-      "line": 134,
+      "line": 162,
       "link": "https://brakemanscanner.org/docs/warning_types/dangerous_eval/",
       "code": "class_eval(\"            # Getter method for the decimal representation of the cents value.\\n            #\\n            # @return [BigDecimal, nil] The decimal value or nil if cents_name is not present.\\n            def #{(:\"#{cents_name.to_sym}_#{suffix}\" or cents_name.to_sym.to_s.gsub(/_cents$/, \"\").to_sym)}\\n              #{cents_name.to_sym}.to_d / #{rate} if #{cents_name.to_sym}.present?\\n            end\\n\\n            # Setter method for the decimal representation of the cents value.\\n            #\\n            # @param value [Numeric, nil] The decimal value to be set.\\n            def #{(:\"#{cents_name.to_sym}_#{suffix}\" or cents_name.to_sym.to_s.gsub(/_cents$/, \"\").to_sym)}=(value)\\n              self.#{cents_name.to_sym} = begin\\n                (BigDecimal(value.to_s) * #{rate}).to_i if value.present?\\n              rescue ArgumentError\\n                nil\\n              end\\n            end\\n\\n            # Mark decimal field as invalid if cents field is not valid\\n            after_validation do\\n              next unless errors[#{cents_name.to_sym.inspect}].present?\\n\\n              errors.add(#{(:\"#{cents_name.to_sym}_#{suffix}\" or cents_name.to_sym.to_s.gsub(/_cents$/, \"\").to_sym).inspect}, :invalid)\\n            end\\n\", \"lib/plutonium/models/has_cents.rb\", 135)",
       "render_path": null,

data/db/migrate/wizard/20260615000001_create_plutonium_wizard_sessions.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+class CreatePlutoniumWizardSessions < ActiveRecord::Migration[7.2]
+  def change
+    create_table :plutonium_wizard_sessions do |t|
+      t.string :wizard, null: false
+      t.string :status, null: false, default: "in_progress" # in_progress | completing | completed
+      t.string :current_step
+
+      # Identity — a deterministic digest of (wizard, scope, anchor, principal).
+      # A single unique column is required because nullable polymorphic columns
+      # can't enforce the singleton rule (NULL != NULL in unique indexes).
+      t.string :instance_key, null: false
+
+      # Polymorphic refs — for querying/listing, NOT identity. *_id is string-typed
+      # to accommodate bigint or uuid host primary keys.
+      t.string :scope_type
+      t.string :scope_id
+      t.string :owner_type
+      t.string :owner_id
+      t.string :anchor_type
+      t.string :anchor_id
+      t.string :token
+
+      # The portal (engine) this run was launched in, e.g. "OrgPortal::Engine" (the
+      # main app's class name for a public mount). Records the run's portal context
+      # so the "continue where you left off" listing only ever shows — and links —
+      # runs that belong to the portal being viewed (two portals can share an entity
+      # scope, so scope alone can't identify the portal).
+      t.string :engine
+
+      # Optimistic-merge version. The runner reads a row at one version and writes
+      # it back a request later; a concurrent advance bumps the version in between.
+      # The store compares the version the state was read at against the row's
+      # current version under a row lock and MERGES (rather than clobbers) when they
+      # differ, so two concurrent writers on the same run never lose each other's
+      # staged data.
+      t.integer :lock_version, null: false, default: 0
+
+      t.public_send(:jsonb, :data, null: false, default: {})
+      t.public_send(:jsonb, :tracked_records, null: false, default: {})
+      # Steps the user has actually visited+validated (§6.3 completeness). A
+      # zero-validation step is only "complete" once it's been visited.
+      t.public_send(:jsonb, :visited, null: false, default: [])
+
+      t.datetime :expires_at
+      t.datetime :completed_at
+      t.timestamps
+
+      t.index :instance_key, unique: true
+      t.index [:status, :expires_at]
+      t.index [:owner_type, :owner_id, :engine, :status]
+      t.index [:scope_type, :scope_id, :status]
+      t.index [:wizard, :anchor_type, :anchor_id, :status]
+    end
+  end
+end

data/docs/.vitepress/config.ts

@@ -1,5 +1,6 @@
 import { defineConfig } from "vitepress"
 import { withMermaid } from "vitepress-plugin-mermaid";
+import llmstxt from "vitepress-plugin-llms";
 
 const base = "/plutonium-core/"
 
@@ -22,6 +23,24 @@ export default defineConfig(withMermaid({
   ],
   ignoreDeadLinks: 'localhostLinks',
   srcExclude: ['superpowers/**'],
+  vite: {
+    plugins: [
+      // Generates llms.txt, llms-full.txt, and a raw .md twin for every page.
+      llmstxt({
+        // Site base (/plutonium-core/) is appended automatically — domain must not include it.
+        domain: "https://radioactive-labs.github.io",
+        // public/ is served verbatim (skills live there); superpowers/ is internal.
+        // Section landing pages are Vue components with no markdown content.
+        ignoreFiles: [
+          "superpowers/**",
+          "public/**",
+          "getting-started/index.md",
+          "guides/index.md",
+          "reference/index.md",
+        ],
+      }),
+    ],
+  },
   themeConfig: {
     // https://vitepress.dev/reference/default-theme-config
     logo: "/plutonium.png",
@@ -32,7 +51,8 @@ export default defineConfig(withMermaid({
       { text: "Home", link: "/" },
       { text: "Getting Started", link: "/getting-started/" },
       { text: "Guides", link: "/guides/" },
-      { text: "Reference", link: "/reference/" }
+      { text: "Reference", link: "/reference/" },
+      { text: "For AI Agents", link: "/ai" }
     ],
     sidebar: {
       '/getting-started/': [
@@ -88,6 +108,8 @@ export default defineConfig(withMermaid({
             { text: "Multi-tenancy", link: "/guides/multi-tenancy" },
             { text: "Search & Filtering", link: "/guides/search-filtering" },
             { text: "User Invites", link: "/guides/user-invites" },
+            { text: "Wizards", link: "/guides/wizards" },
+            { text: "Kanban Boards", link: "/guides/kanban" },
           ]
         },
         {
@@ -177,6 +199,28 @@ export default defineConfig(withMermaid({
             { text: "Invites", link: "/reference/tenancy/invites" },
           ]
         },
+        {
+          text: "Wizard",
+          collapsed: false,
+          items: [
+            { text: "Overview", link: "/reference/wizard/" },
+            { text: "DSL", link: "/reference/wizard/dsl" },
+            { text: "Anchoring & resume", link: "/reference/wizard/anchoring-resume" },
+            { text: "Storage & config", link: "/reference/wizard/storage-config" },
+            { text: "Registration & launch", link: "/reference/wizard/registration-launch" },
+            { text: "One-time", link: "/reference/wizard/one-time" },
+          ]
+        },
+        {
+          text: "Kanban",
+          collapsed: false,
+          items: [
+            { text: "Overview", link: "/reference/kanban/" },
+            { text: "DSL", link: "/reference/kanban/dsl" },
+            { text: "Positioning", link: "/reference/kanban/positioning" },
+            { text: "Authorization", link: "/reference/kanban/authorization" },
+          ]
+        },
         {
           text: "Testing",
           collapsed: false,

data/docs/.vitepress/sync-skills.mjs

@@ -0,0 +1,45 @@
+// Syncs .claude/skills/*/SKILL.md into docs/public/skills/ so the docs site
+// serves them as raw, crawlable markdown at /skills/<name>.md.
+// Runs before `docs:dev` and `docs:build` (see package.json). Output is gitignored.
+import { readdirSync, readFileSync, writeFileSync, mkdirSync, rmSync, existsSync } from "node:fs"
+import { join, dirname } from "node:path"
+import { fileURLToPath } from "node:url"
+
+const root = join(dirname(fileURLToPath(import.meta.url)), "..", "..")
+const skillsDir = join(root, ".claude", "skills")
+const outDir = join(root, "docs", "public", "skills")
+
+rmSync(outDir, { recursive: true, force: true })
+mkdirSync(outDir, { recursive: true })
+
+const skills = []
+
+for (const entry of readdirSync(skillsDir, { withFileTypes: true })) {
+  if (!entry.isDirectory()) continue
+  const source = join(skillsDir, entry.name, "SKILL.md")
+  if (!existsSync(source)) continue // skip dirs that aren't skills (no SKILL.md)
+  let content = readFileSync(source, "utf8")
+
+  const description = content.match(/^description:\s*(.+)$/m)?.[1] ?? ""
+
+  // Wiki-style [[skill-name]] cross-links become relative markdown links so
+  // crawlers can follow them between the published files.
+  content = content.replace(/\[\[([\w-]+)\]\]/g, "[$1]($1.md)")
+
+  writeFileSync(join(outDir, `${entry.name}.md`), content)
+  skills.push({ name: entry.name, description })
+}
+
+skills.sort((a, b) => (a.name === "plutonium" ? -1 : b.name === "plutonium" ? 1 : a.name.localeCompare(b.name)))
+
+const index = `# Plutonium Skills
+
+Task-focused guides for AI agents working with the [Plutonium](https://radioactive-labs.github.io/plutonium-core/) Rails RAD framework. Each file is self-contained markdown. Start with \`plutonium.md\` — it routes to the others.
+
+These are the same skills the gem installs into projects via \`rails g pu:skills:sync\` (Claude Code loads them automatically from \`.claude/skills/\`). Any agent can fetch them directly from the URLs below.
+
+${skills.map((s) => `- [${s.name}](${s.name}.md) — ${s.description}`).join("\n")}
+`
+
+writeFileSync(join(outDir, "index.md"), index)
+console.log(`Synced ${skills.length} skills to docs/public/skills/`)

data/docs/ai.md

@@ -0,0 +1,99 @@
+---
+title: Plutonium for AI Agents
+description: Machine-readable entry point for AI coding agents building Rails apps with Plutonium — install commands, conventions, generator catalog, and skill files.
+sidebar: false
+---
+
+# Plutonium for AI Agents
+
+You are reading the agent entry point for **Plutonium**, a Rails RAD framework (Ruby gem) that provides resource-oriented architecture: automatic CRUD, authorization policies, declarative UI definitions, authentication, and multi-tenancy. If a user asked you to build something with Plutonium, this page gives you the golden path and where to read next.
+
+## Machine-readable resources
+
+| Resource | URL |
+|---|---|
+| Docs index (llms.txt) | `https://radioactive-labs.github.io/plutonium-core/llms.txt` |
+| Full docs, one file | `https://radioactive-labs.github.io/plutonium-core/llms-full.txt` |
+| Agent skills index | `https://radioactive-labs.github.io/plutonium-core/skills/index.md` |
+| Router skill (start here) | `https://radioactive-labs.github.io/plutonium-core/skills/plutonium.md` |
+
+Every docs page also has a raw markdown twin: append `.md` to its URL (e.g. `/guides/multi-tenancy.md`).
+
+**Prefer the skills over the raw docs.** They are task-focused, deduplicated, and encode the mistakes agents actually make. The router skill maps "about to do X" to the right skill file. If you are Claude Code, run `rails g pu:skills:sync` after installing the gem to install them into `.claude/skills/` so they load automatically.
+
+## Rules that prevent expensive mistakes
+
+1. **Plutonium is generator-driven.** Nearly every file has a `pu:*` generator. Generate, then edit — never hand-write models, definitions, policies, or packages from scratch. Hand-written files drift from conventions and break future generator runs.
+2. **Inspect before you act.** Check `Gemfile` for `plutonium`, `ls config/packages.rb`, and `ls packages/` before installing or scaffolding anything.
+3. **New app → `plutonium.rb` template. Existing app → `base.rb` template.** Never run `plutonium.rb` on an existing app; it re-runs full bootstrap and clobbers git history.
+4. **Pass flags to avoid interactive prompts**: `--dest=main_app` (or `--dest=<package>`), `--force` when re-running meta-generators, `--auth=<account>` for portals, `--skip-bundle`, `--quiet`.
+5. **Quote field arguments with special characters**: `'title:string?'`, `'price:decimal{10,2}'`.
+6. **Multi-tenancy is structural, not filtered in policies.** The portal declares `scope_to_entity`; the model provides the association path that `associated_with` resolves. Never `where(organization: ...)` in a policy — read the tenancy skill first.
+
+## Golden path: new application
+
+```bash
+rails new myapp -a propshaft -j esbuild -c tailwind \
+  -m https://radioactive-labs.github.io/plutonium-core/templates/plutonium.rb
+cd myapp
+rails db:prepare
+```
+
+Then for each resource:
+
+```bash
+rails g pu:res:scaffold Post 'title:string' 'body:text?' user:references --dest=main_app
+rails db:prepare
+rails g pu:res:conn Post --dest=<portal_package>
+```
+
+## Golden path: existing application
+
+```bash
+bin/rails app:template \
+  LOCATION=https://radioactive-labs.github.io/plutonium-core/templates/base.rb
+```
+
+Or manually: add `gem "plutonium"` to the Gemfile, `bundle install`, then `rails g pu:core:install`.
+
+## Architecture in one table
+
+A **resource** is four cooperating layers. Plutonium auto-fills defaults from the model; you only declare overrides.
+
+| Layer | File | Purpose |
+|---|---|---|
+| Model | `app/models/post.rb` | Data, validations, associations |
+| Definition | `app/definitions/post_definition.rb` | UI — fields, filters, actions |
+| Policy | `app/policies/post_policy.rb` | Authorization |
+| Controller | `app/controllers/posts_controller.rb` | Rarely edited — use hooks |
+| Interaction (optional) | `app/interactions/publish_post_interaction.rb` | Business logic for custom actions |
+
+Resources live in the main app or in **feature packages**; users access them through **portal packages** (Rails engines with their own auth and optional tenant scoping).
+
+## Generator catalog
+
+Discover all generators with `rails g --help | grep pu:`. The most used:
+
+| Generator | Purpose |
+|---|---|
+| `pu:core:install` | Initial Plutonium setup |
+| `pu:res:scaffold NAME field:type ... --dest=` | New resource (model, migration, policy, definition) |
+| `pu:res:conn RESOURCE --dest=PORTAL` | Connect a resource to a portal |
+| `pu:pkg:package NAME` | Feature package |
+| `pu:pkg:portal NAME --auth=...` | Portal package |
+| `pu:rodauth:install` / `pu:rodauth:account NAME` | Authentication |
+| `pu:saas:setup --user ... --entity ...` | Full SaaS bootstrap: user + tenant + membership + portal |
+| `pu:test:install` / `pu:test:scaffold NAME` | Testing scaffolds |
+| `pu:skills:sync` | Install the agent skill files into the project |
+
+## Verify your work
+
+```bash
+rails runner "puts Plutonium::VERSION"   # gem installed and loaded
+rails db:prepare                          # migrations applied
+bin/dev                                   # boot; visit the portal route
+```
+
+## For humans reading this
+
+This page exists so AI coding agents can bootstrap correctly on the first try. Point your agent at it, or just say: *"Read https://radioactive-labs.github.io/plutonium-core/ai.md before starting."* The [Getting Started guide](/getting-started/) covers the same ground for people.

data/docs/guides/index.md

@@ -25,6 +25,8 @@ aside: false
       { name: 'Nested resources', link: '/plutonium-core/guides/nested-resources' },
       { name: 'Multi-tenancy', link: '/plutonium-core/guides/multi-tenancy' },
       { name: 'Search & filtering', link: '/plutonium-core/guides/search-filtering' },
+      { name: 'Wizards', desc: 'Multi-step flows — onboarding, checkout, branching create.', link: '/plutonium-core/guides/wizards' },
+      { name: 'Kanban boards', desc: 'Drag-and-drop board view — columns, moves, positioning, WIP limits.', link: '/plutonium-core/guides/kanban' },
     ]},
     { group: 'Customization', items: [
       { name: 'Customizing the UI', desc: 'A map of the override surface — pages, forms, displays, tables, components, layouts.', link: '/plutonium-core/guides/customizing-ui' },