Release Notes — November 2026
v9.3.1 (2026-11-17)
Catalyst v9.3.1 — 2026-11-17
🚀 Features
- 📎 MCP create and update tools now support file fields using
signed_id, base64 data, or public URLs. Signed direct uploads let clients upload large files without sending the file bytes through chat; uploads are capped at 500 MB. #1874 (#Kishore-Girivasan)
🐛 Bug Fixes
- 🛠️ Made contract and blueprint eager-load path registration idempotent, fixing test boot failures when
config.eager_load_pathsis frozen. #1878 (#BrijeshSajeev)
✨ Improvements
- ♻️ Continued the service-layer refactor by moving remaining non-trivial controller logic for admin actions, authentication, webhooks, API support tickets, and MCP token lookup into focused service objects. Existing webhook override hooks and API error-formatting compatibility are preserved. #1878 (#BrijeshSajeev)
- 🛡️ MCP URL uploads reject loopback, private, and link-local addresses, do not follow redirects, and validate the destination before downloading. #1874 (#Kishore-Girivasan)
⚠️ Breaking Changes
- No breaking changes in this release.
📚 Documentation
- 📚 Updated the MCP server guide with file upload inputs, signed direct-upload instructions, upload limits, and create/update attachment behavior. #1874 (#Kishore-Girivasan)
- 📚 Added the v9.3.0 upgrade guide, covering RubyLLM persistence migration steps, breaking changes, configuration updates, and a deployment checklist. d38313a74
- 📚 Updated the November changelog with v9.3.0 release details and its migration warnings. 5145227df
v9.3.0 (2026-11-17)
Catalyst v9.3.0 — 2026-11-17
⚠️ WARNING: Breaking Changes — Existing Catalyst AI installs must migrate to RubyLLM persistence. Message attachments are renamed from files to attachments, and ct_bot_messages.role becomes a string enum; update app code that uses the old attachment parameter or association.
🔄 WARNING: Migration Required — For existing Catalyst AI installs, run the generator and database migration below to add RubyLLM persistence and update existing bot data. Do not rerun add_bot_conversations.
rails generate cm_admin:add_ruby_llm_persistence && rails db:migrate
🚀 Features
- 🤖 Catalyst AI conversations now use RubyLLM's ActiveRecord chat lifecycle, persisting message history, tool calls, approvals, and usage across retries and restarts. #1857 (#Mahaveer1141)
🐛 Bug Fixes
- No bug fixes in this release.
✨ Improvements
- ✅ Confirmed write actions now execute immediately using the exact persisted tool-call arguments the user reviewed. #1857 (#Mahaveer1141)
- 🔁 Reply jobs back off while a conversation has an active run claim, avoiding duplicate answers; queued messages are included when the reply continues. #1857 (#Mahaveer1141)
- 💰 LLM usage and request payloads are recorded in
ruby_llm_usages, with costs associated with messages and conversations. #1857 (#Mahaveer1141) - 💬 The chat widget shows a waiting indicator for messages awaiting a reply and hides blank assistant messages that contain only tool calls. #1857 (#Mahaveer1141)
⚠️ Breaking Changes
- 🔧 Existing Catalyst AI installs must run the new RubyLLM persistence generator and migrate. The migration changes message roles to a string enum and renames attachments from
filestoattachments; update code using thefilesparameter or association. #1857 (#Mahaveer1141)
📚 Documentation
- 📚 Updated the Catalyst AI and generator guides with the RubyLLM persistence model, existing-install migration steps, and the new
add_ruby_llm_persistencegenerator. Added the v9.2.10 upgrade guide and updated the November changelog and release index. #1857 (#Mahaveer1141)
v9.2.10 (2026-11-16)
Catalyst v9.2.10 — 2026-11-16
🚀 Features
No new features in this release.
🐛 Bug Fixes
- 🛡️ Admin and MCP writes now check the saved record against the user's permission scope. This closes a gap where scopes using
INsubqueries,ORconditions, or joins could allow an out-of-scope create or move. #1873 (#Kishore-Girivasan)
✨ Improvements
- 🔒 The scope check and save now run in a transaction; out-of-scope writes are rolled back and raise
Pundit::NotAuthorizedError. Admin create and update, progressive save, and MCP create and update use the same check. #1873 (#Kishore-Girivasan)
⚠️ Breaking Changes
No breaking changes.
📚 Documentation
- 📚 Added the v9.2.9 upgrade guide, including manual review steps for MCP create workflows that submit
belongs_toIDs, and updated the November changelog and release index. ae33fb5b6 · 082e3d7b6
v9.2.9 (2026-11-16)
Catalyst v9.2.9 — 2026-11-16
🚀 Features
- 🔗 MCP create tools now expose eligible
belongs_toforeign keys as optional<association>_idinputs when thecm_newform does not already declare them. This lets clients create child records with their parent association. #1864 (#Kishore-Girivasan)
🐛 Bug Fixes
- ✅ MCP create tools now resolve submitted
belongs_tovalues through the parent model’s index scope and checkshowpermission before saving. Unknown or unauthorized parents are rejected, closing an authorization gap. #1864 (#Kishore-Girivasan)
✨ Improvements
- 🧩 Foreign-key exposure is limited to supported associations: polymorphic associations, parents without a Catalyst model, update tools, and nested form rows are not affected. #1864 (#Kishore-Girivasan)
⚠️ Breaking Changes
No breaking changes.
📚 Documentation
- 📚 Updated the MCP server guide to explain eligible association inputs, how to find parent IDs, and the visibility checks applied to submitted associations. #1864 (#Kishore-Girivasan)
- 📚 Added a v9.2.8 upgrade guide covering the manual review needed for explicit History actions on models without PaperTrail, and updated the November changelog for v9.2.8. 376e96011 · 7b12158b4
v9.2.8 (2026-11-16)
Catalyst v9.2.8 — 2026-11-16
🚀 Features
- 🛠️ Added
rails cm_admin:install_migrationsto copy pending Catalyst migration templates into the host app’sdb/migratedirectory in one command. It does not rundb:migrate, so you can review the generated files before applying them. #1837 (#austinjb32)
🐛 Bug Fixes
- 🧾 The History action is now available only for models that support PaperTrail, preventing history pages from failing on models without version records. #1868 (#mikevic)
✨ Improvements
- ✅ Restored hosted GitHub Actions linting for changed Ruby and SCSS files, and removed the local lint-and-signoff workflow. #1871 (#BrijeshSajeev)
⚠️ Breaking Changes
No breaking changes.
📚 Documentation
- 📚 Expanded the v9.2.4 upgrade guide with Catalyst AI artifact payload changes, compatibility details, and steps to update code and remove or reshape pre-upgrade artifact rows. #1872 (#Mahaveer1141)
- 📚 Added the v9.2.7 upgrade guide and updated the November changelog with v9.2.7 release notes. 123441dc9 · 5da36af6c
- 📚 Documented how to copy pending migrations with
rails cm_admin:install_migrations, including what the task does and which migrations it skips. #1837 (#austinjb32)
v9.2.7 (2026-11-16)
Catalyst v9.2.7 — 2026-11-16
🚀 Features
- 👁️ Columns configured with
viewable: falseare hidden by default but remain available in the Manage Columns panel. Users can enable them, and their choices persist with column preferences. #1856 #BrijeshSajeev - 🎥 Rich-text videos now play inline on Show and Comments pages, with playback-speed controls and a download button. #1830 #app/devin-ai-integration
🐛 Bug Fixes
No bug fixes are listed for this release.
✨ Improvements
No additional product improvements are listed for this release.
⚠️ Breaking Changes
No breaking changes.
📚 Documentation
- 📚 Updated the DSL reference to explain that
viewable: falsehides a column on initial load while keeping it available in Manage Columns, and that user preferences persist. #1856 #BrijeshSajeev - 📚 Added project coding standards covering styles, the CM Admin DSL, Active Record, jobs, migrations, service objects, formatting, comments, and commit messages. #1865 #mikevic
- 📚 Documented how Devin and Claude Code rules are sourced and synchronized, including the relevant folders and sync commands. #1866 #mikevic
- 📚 Updated the November changelog with the v9.2.6 release notes. 19895dc44
v9.2.6 (2026-11-12)
Catalyst v9.2.6 — 2026-11-12
🚀 Features
No feature changes are listed in the provided release input.
🐛 Bug Fixes
No bug fixes are listed in the provided release input.
✨ Improvements
No product improvements are listed in the provided release input.
⚠️ Breaking Changes
No breaking changes for v9.2.6 are listed in the provided release input.
📚 Documentation
- 📚 Added a v9.2.5 upgrade guide covering MCP tool contract changes, authorization behavior, filtering and option lookup restrictions, field output changes, and host-app review steps. No database migration or rake task is required for that upgrade. 249cea2c4
- 📚 Updated the November 2026 changelog with v9.2.5 release notes, including its features, fixes, improvements, breaking changes, and documentation updates. d863202e9
v9.2.5 (2026-11-12)
Catalyst v9.2.5 — 2026-11-12
⚠️ WARNING: Breaking Changes — The MCP tool contract changed: <model>_show is now <model>_get, and fetch_options no longer accepts model_name. Update MCP clients that rely on those names or arguments. No host-app database migration or rake task is required.
🚀 Features
- 🤖 Added MCP aggregate tools for
count,sum,avg,min, andmax, with optional grouping and index-scope filtering. #1811 @git-pranavr - 👥 Added the optional
install_user_groupsgenerator to create User Groups tables and seed the feature setting. #1855 @Kishore-Girivasan
🐛 Bug Fixes
- 🛡️ Hardened MCP authorization: calls now fail closed when policies or scopes are missing, restrict option lookup to approved helper methods, validate aggregate columns, and avoid exposing raw exception details. #1811 @git-pranavr
- 🪟 Fixed new and edit drawers returning HTTP 500 by setting the current action before rendering their forms. #1834 @git-pranavr
- 🎨 Fixed progressive form and stepper styling to use design tokens, bulk-action requests without a
Refererheader, and pagination inside lazy dashboard widgets. #1852 @austinjb32 - 📦 Fixed review-app releases failing with
json3 by upgrading Sprockets to 4.4.1. #1853 @mikevic
✨ Improvements
- 📐 MCP tool output schemas now match actual results, including nullable values, money, decimals, and response schemas for discovery and option-fetching tools. #1811 @git-pranavr
- 🧰 The User Groups generator derives its migration version from
ActiveRecord.version, improving compatibility across Rails versions. #1855 @Kishore-Girivasan
⚠️ Breaking Changes
- ⚠️ MCP clients must use
<model>_getinstead of<model>_show; thefetch_optionsmodel_nameargument and thex-model-namefilter metadata have been removed. Models without declared fields now return onlyid. Update affected clients and integrations before relying on the changed contract. #1811 @git-pranavr
📚 Documentation
- 📚 Updated the MCP guide with the current tool names and schemas, aggregate behavior, option lookup rules, and fail-closed authorization behavior. #1811 @git-pranavr
- 📚 Documented the optional User Groups generator, its setup steps, and the feature’s behavior. #1855 @Kishore-Girivasan
v9.2.4 (2026-11-11)
Catalyst v9.2.4 — 2026-11-11
⚠️ WARNING: Breaking Changes — Alert markup and styling changed to use Bootstrap 6’s alert component. Applications that target the previous alert structure or styles may need to update their custom CSS or views. No migration or rake command is required.
🚀 Features
- 🤖 Added opt-in MCP model update tools. Models can expose update actions through their configured MCP actions. #1847 @Mahaveer1141
- 🤖 Catalyst AI now supports confirmed write actions, including opt-in record creation, richer multi-question prompts, and a
current_usertool. Write calls wait for user approval before running. #1835 @Mahaveer1141 - 🧩 Added a ViewComponent foundation with reusable UI primitives and Lookbook previews for components. #1806 @mikevic
- 🚀 Custom action modal alerts now render with Turbo Streams.
b84c7dcbd
🐛 Bug Fixes
- 🐛 Fixed alert rendering so alerts across Catalyst consistently use Bootstrap 6’s alert component. #1838 @barath46
- 🛡️ Fixed authorization handling when a policy instance is nil, and centralized permission and policy operations in
CmAdmin::Authorization. #1836 @Mahaveer1141 - 🛠️ Updated review-app workflows to support reusable workflow calls and limit pull request runs to close events. #1851 @Mahaveer1141
✨ Improvements
- 🔒 Updated Rails components, Rack, and Nokogiri dependencies with security and maintenance fixes. #1840 @app/dependabot, #1842 @app/dependabot, #1843 @app/dependabot, #1848 @app/dependabot, #1839 @app/dependabot, #1845 @app/dependabot
- ⚙️ Simplified the Windows platform specification for
tzinfo-dataacross the Gemfiles. #1844 @mikevic - 🔧 Improved review-app configuration by passing through the AI key, using the async Action Cable adapter, and ignoring feature-app credential key files. #1847 @Mahaveer1141
⚠️ Breaking Changes
- ⚠️ Alert markup and styles now follow Bootstrap 6’s
.alert.theme-<type>component. The previous alert layout and several custom styling rules were removed. If your application relied on the old markup or appearance, update its custom styles; the UI guide documents the new structure. #1838 @barath46
📚 Documentation
- 📚 Expanded the Catalyst AI and MCP guides with details on confirmation-based writes, question types, create and update tools,
current_user, record URLs, and policy checks. #1835 @Mahaveer1141, #1847 @Mahaveer1141 - 📚 Updated the UI guide to explain the Bootstrap 6 alert markup and styling changes, and documented the shared authorization API in feature guidance. #1838 @barath46, #1836 @Mahaveer1141
- 📚 Added this release to the November 2026 changelog and refreshed the release metadata.
v9.2.3 (2026-11-10)
Catalyst v9.2.3 — 2026-11-10
🚀 Features
- 🚀 Added an automated workflow to generate an upgrade guide after stable gem releases, update the Upgrade Guide index, and record guide metadata in
releases.json. #1820 @anbublacky
🐛 Bug Fixes
No user-facing bug fixes in this release.
✨ Improvements
- ✨ Progressive-form system specs no longer incur unnecessary Capybara timeouts, reducing test runtime without skipping or loosening tests. #1833 @mikevic
- ✨ Updated docs-site dependencies, including security fixes for CSS parsing, selector parsing, URI handling, request parsing, and HTTP handling. #1771 @app/dependabot, #1748 @app/dependabot, #1728 @app/dependabot, #1727 @app/dependabot, #1726 @app/dependabot. Also refreshed related docs-site packages: #1795 @app/dependabot, #1794, #1762, #1729 @app/dependabot, @app/dependabot, @app/dependabot.
- ♻️ Shared OpenRouter and structured-output services across release tooling.
5a2d79d84
⚠️ Breaking Changes
No breaking changes in this release.
📚 Documentation
- 📚 Expanded the Upgrade Guide index with guidance on which releases need a guide, applying guides in version order, and how AI agents should handle releases requiring human intervention. The release workflow also updates the index and
releases.jsonwhen it publishes a guide. #1820 @anbublacky
v9.2.2 (2026-11-10)
Catalyst v9.2.2 — 2026-11-10
🚀 Features
- 🚀 Error reporting now uses
Rails.errorwithsource: "cm_admin", allowing each app to route reports to its configured tracker. Existing Airbrake/Errbit integrations remain supported without changes. #1829 @mikevic
🐛 Bug Fixes
- 🐛 Resolve the configured user class on every call, preventing stale class references from causing sign-in failures after code reloads in development. #1832 @mikevic
- 🐛 Fixed a flaky
display_ifspec by using a fixed test-user name, so random generated names no longer interfere with page-content assertions. #1831 @mikevic
✨ Improvements
- ✨ Error reports are routed through Rails’ error-reporting system instead of calling Airbrake directly, making it easier to use different trackers. Apps using Sentry can enable Rails error subscriber registration as described in the documentation. #1829 @mikevic
⚠️ Breaking Changes
No breaking changes in this release.
📚 Documentation
- 📚 Added an Error Reporting guide covering Rails error reporting, Airbrake/Errbit compatibility, and Sentry configuration. Updated the Catalyst AI documentation to reference the new reporting path. #1829 @mikevic
v9.2.1 (2026-11-09)
Catalyst v9.2.1 — 2026-11-09
🚀 Features
No feature changes are listed in the supplied release log.
🐛 Bug Fixes
No bug fixes are listed in the supplied release log.
✨ Improvements
No improvements are listed in the supplied release log.
⚠️ Breaking Changes
No breaking changes are listed for v9.2.1 in the supplied release information.
📚 Documentation
- 📚 Added the v9.2.0 release entry to the November 2026 changelog, documenting its Bootstrap 6 migration, compatibility notes, and CSS build guidance. Updated the release catalog as well. 762653154
v9.2.0 (2026-11-06)
Catalyst v9.2.0 — 2026-11-06
⚠️ WARNING: Breaking Changes — Catalyst has migrated from Bootstrap 5 to Bootstrap 6 (6.0.0-alpha.1). Applications with custom admin views, styles, or scripts may need to update component markup, CSS classes, JavaScript APIs, and their CSS build setup. Review the Bootstrap 6 migration notes and the updated Catalyst UI documentation. No database migration is required.
🚀 Features
No new features in this release.
🐛 Bug Fixes
- 🐛 Fixed Bootstrap 6 UI regressions across menus, dialogs, tables, forms, alerts, toasts, date pickers, and nested tables to preserve Catalyst’s established layout and styling. #1680 (#barath46)
✨ Improvements
- ✨ Migrated Catalyst’s CSS foundation and JavaScript components from Bootstrap 5 to Bootstrap 6 alpha. The update includes revised component markup and APIs, updated Catalyst styles, and Bootstrap 6-compatible button and theme classes. #1680 (#barath46)
- ✨ Updated the CSS build to use Dart Sass for Bootstrap 6. The CSS bundler runs during
assets:precompile; if you need to build the stylesheets directly, runrake cm_admin:scss:build. Applications that still usesassc-railsfor other stylesheets should setconfig.assets.css_compressor = nilin non-development environments to prevent libsass from re-compressing the generated CSS. #1680 (#barath46)
⚠️ Breaking Changes
- ⚠️ Replaced Bootstrap 5 components and APIs with Bootstrap 6 equivalents. Custom admin code may need updates, including
Modal→Dialog,Dropdown→Menu, andOffcanvas→Drawer, along with related markup, classes, events, CSS variables, and spacing utilities. #1680 (#barath46)
📚 Documentation
- 📚 Updated the UI introduction and button reference for Bootstrap 6, including migration guidance for host applications’ CSS builds, cascade layers, markup, JavaScript APIs, and color modes. Added a CSS bundler note explaining the Dart Sass requirement and the
sassc-railscompressor caveat. #1680 (#barath46)
v9.1.0 (2026-11-06)
Catalyst v9.1.0 — 2026-11-06
🔄 WARNING: Migration Required — Progressive forms use a new ct_form_drafts database table. Generate and run the migration before using progressive forms:
bin/rails generate cm_admin:form_draft
bin/rails db:migrate
🚀 Features
- 🚀 Added multi-step progressive forms to
cm_newandcm_edit. Declare ordered steps in the form DSL; each step renders independently, validates its own fields, and provides Back/Next navigation. #1712 (#austinjb32) - 🚀 Added server-side form drafts to preserve values between steps, including staged file uploads. Drafts are cleared after a successful save or when the user discards the form. #1712 (#austinjb32)
- 🚀 Added in-place step transitions with Turbo Streams, step jumps that preserve draft state, and a discard flow that purges the draft and staged files. #1712 (#austinjb32)
🐛 Bug Fixes
No bug fixes in this release.
✨ Improvements
- ✨ Added the
form_draftgenerator and migration template so host applications can create the table required for progressive-form drafts. #1712 (#austinjb32)
⚠️ Breaking Changes
No breaking changes in this release.
📚 Documentation
- 📚 Added a Progressive Forms guide covering the DSL, navigation, validation, draft state, staged uploads, examples, and limitations. Updated the New and Edit DSL guides with step-based form examples and behavior. #1712 (#austinjb32)
v9.0.1 (2026-11-06)
Catalyst v9.0.1 — 2026-11-06
🔄 WARNING: Migration Required — The optional User Groups feature needs its tables created before use. Installations that do not enable User Groups do not need to run these commands.
bin/rails generate cm_admin:install_user_groups
bin/rails db:migrate
🚀 Features
- 🚀 Added optional User Groups support for role selection on user forms. Admins can group roles, and user form role dropdowns can filter to the selected group. The feature is disabled by default. #1807 (#Kishore-Girivasan)
🐛 Bug Fixes
- 🐛 Fixed switch fields so string values such as
"1"and"true"render as checked. #1807 (#Kishore-Girivasan) - 🐛 Corrected the unique constraint syntax in the User Groups migration. #1807 (#Kishore-Girivasan)
✨ Improvements
- ✨ Added the
cm_admin:install_user_groupsgenerator to create the User Groups tables and seed the default setting when opting into the feature. #1807 (#Kishore-Girivasan)
⚠️ Breaking Changes
No breaking changes in this release.
📚 Documentation
- 📚 Renumbered the platform-settings upgrade guide from v8.6.0 to v9.0.0 and updated the upgrade-guide index. #1825 (#austinjb32)
- 📚 Expanded contributor and agent guidance with the local lint and GitHub signoff process, contribution workflow, and Stylelint instructions. #1800 (#app/devin-ai-integration)
- 📚 Added the v9.0.0 entry to the November 2026 changelog and updated the release registry. 94b23459a
v9.0.0 (2026-11-05)
Catalyst v9.0.0 — 2026-11-05
⚠️ WARNING: Breaking Changes — Project settings are now separate from platform settings, and
cm_custom_methodhas been renamed tocm_custom_action. Move project values intoconfig/application.rband update affected references. No database migration or rake task is required.
🚀 Features
- 🚀 Adopted
ar_lazy_preloadfor admin index and filtering associations. Associations are batch-loaded on first access rather than eagerly at query time, while preserving N+1 protection. #1764 (#austinjb32)
🐛 Bug Fixes
- 🐛 Regenerated stale root and Rails 8.0/8.1 appraisal lockfiles so frozen Bundler installs can resolve the current gem version and dependencies. #1823 (#austinjb32)
✨ Improvements
- ✨ Platform settings now use a
Rails.cache-backed reader, with cache invalidation on changes so updates apply across processes without a restart. Missing settings raiseCmAdmin::PlatformSettings::NotFound, andfetchsupports explicit fallbacks. #1803 (#mikevic) - 🛡️ Reworked MCP authentication and tool registration around a per-request Rails controller flow and class-based
MCP::Tooltools. Authorization now fails closed when a policy scope is missing. #1805 (#Mahaveer1141) - ✨ MCP tools now set the current user's permissions before each tool execution, keeping permission setup with authorization logic. #1824 (#Mahaveer1141)
- ♻️ Refactored resource-controller request handling into declarative action services and shared helpers, making response behavior more explicit and testable. #1818 (#Mahaveer1141) #1801 (#mikevic)
⚠️ Breaking Changes
-
⚠️ Project settings are no longer overridden by platform-setting rows. Move any admin-managed project name, slug, logo URL, favicon URL, or default email into
config/application.rb. The oldPLATFORM_SETTINGSconstant is deprecated; file settings now return a path string rather than a lambda, and missing slugs raise an error instead of returningnil. Replacecm_custom_methodreferences withcm_custom_action. #1803 (#mikevic) #1818 (#Mahaveer1141)To preserve project values, set the relevant values in
config/application.rb, for example:config.x.project_settings.name = "Acme"config.x.project_settings.slug = "acme"config.x.project_settings.logo_url = "https://cdn.example.com/logo.png"config.x.project_settings.favicon_url = "https://cdn.example.com/favicon.png"config.x.project_settings.default_from_email = "no-reply@example.com"If legacy project-setting rows exist, remove them from a Rails console:
CmPlatformSetting.where(slug: %w[project-name project-slug logo-url favicon-url default-email]).destroy_allReplace
PLATFORM_SETTINGS[...]withCmAdmin::PlatformSettings[...]or.fetch(slug, default)where a fallback is expected. Remove.callfrom file-setting access, and remove calls toCmPlatformSetting.sync_project_settings_to_config. No database migration or rake task is required.
📚 Documentation
- 📚 Updated the DSL guide to explain lazy association preloading and the optional
ArLazyPreload.config.auto_preload = trueinitializer setting. #1764 (#austinjb32) - 📚 Updated MCP documentation with the controller-based authentication and tool architecture, Rails console tool usage, and the fields returned by list and get tools. #1805 (#Mahaveer1141)
- 📚 Added platform-settings guidance covering the distinction between project and platform settings, cache behavior, lookup methods, fallbacks, and file-setting paths. #1803 (#mikevic)
- 📚 Updated auditing documentation to use the renamed
cm_custom_actionmethod. #1818 (#Mahaveer1141)
v8.5.4 (2026-11-05)
Catalyst v8.5.4 — 2026-11-05
⚠️ WARNING: Breaking Changes — Platform settings are now separate from project settings, and
cm_custom_methodhas been renamed tocm_custom_action. Move project values intoconfig/application.rb, update references to the renamed action and deprecated settings API, and remove obsolete project-setting rows as described below. No database migration or rake task is required.
🚀 Features
- 🚀 Adopted
ar_lazy_preloadfor admin index and filtering associations. Associations are batch-loaded on first access rather than eagerly at query time, while preserving N+1 protection. #1764 (#austinjb32)
🐛 Bug Fixes
- 🐛 Regenerated stale root and Rails 8.0/8.1 appraisal lockfiles so frozen Bundler installs can resolve the current gem version and dependencies. #1823 (#austinjb32)
✨ Improvements
- ✨ Platform settings now use a
Rails.cache-backed reader, with cache invalidation on changes so updates apply across processes without a restart. Missing settings raiseCmAdmin::PlatformSettings::NotFound, andfetchsupports explicit fallbacks. #1803 (#mikevic) - 🛡️ Reworked MCP authentication and tool registration around a per-request Rails controller flow and class-based
MCP::Tooltools. Authorization now fails closed when a policy scope is missing. #1805 (#Mahaveer1141) - ✨ MCP tools now set the current user's permissions before each tool execution, keeping permission setup with authorization logic. #1824 (#Mahaveer1141)
- ♻️ Refactored resource-controller request handling into declarative action services and shared helpers, making response behavior more explicit and testable. #1818 (#Mahaveer1141) #1801 (#mikevic)
⚠️ Breaking Changes
-
⚠️ Project settings are no longer overridden by platform-setting rows. Move any admin-managed project name, slug, logo URL, favicon URL, or default email into
config/application.rb. The oldPLATFORM_SETTINGSconstant is deprecated; file settings now return a path string rather than a lambda, and missing slugs raise an error instead of returningnil. Replacecm_custom_methodreferences withcm_custom_action. #1803 (#mikevic) #1818 (#Mahaveer1141)To preserve project values, set the relevant values in
config/application.rb, for example:config.x.project_settings.name = "Acme"config.x.project_settings.slug = "acme"config.x.project_settings.logo_url = "https://cdn.example.com/logo.png"config.x.project_settings.favicon_url = "https://cdn.example.com/favicon.png"config.x.project_settings.default_from_email = "no-reply@example.com"If the legacy rows exist, remove them from a Rails console:
CmPlatformSetting.where(slug: %w[project-name project-slug logo-url favicon-url default-email]).destroy_allReplace
PLATFORM_SETTINGS[...]withCmAdmin::PlatformSettings[...]or.fetch(slug, default)where a fallback is expected. Remove.callfrom file-setting access, and remove calls toCmPlatformSetting.sync_project_settings_to_config. No migration or rake command is required.
📚 Documentation
- 📚 Updated the DSL guide to explain lazy association preloading and the optional
ArLazyPreload.config.auto_preload = trueinitializer setting. #1764 (#austinjb32) - 📚 Updated MCP documentation with the controller-based authentication and tool architecture, Rails console tool usage, and the fields returned by list and get tools. #1805 (#Mahaveer1141)
- 📚 Added platform-settings guidance covering the distinction between project and platform settings, cache behavior, lookup methods, fallbacks, and file-setting paths. #1803 (#mikevic)
- 📚 Updated auditing documentation to use the renamed
cm_custom_actionmethod. #1818 (#Mahaveer1141)
v8.5.3 (2026-11-04)
Catalyst v8.5.3 — 2026-11-04
🚀 Features
- 🚀 File fields now support Active Storage direct uploads for
single_file_uploadandmulti_file_upload. Files upload directly to the storage service, with per-file progress feedback, while preserving normal form-upload behavior when direct uploads are unavailable. #1814 (#austinjb32)
🐛 Bug Fixes
- 🐛 Restored appends to the engine’s
eager_load_pathsin the initializer. dfc4635
✨ Improvements
No additional improvements in this release.
⚠️ Breaking Changes
No breaking changes in this release.
📚 Documentation
- 📚 Updated review-app deployment guidance to note that the Tigris bucket needs CORS rules for browser-based direct uploads, and updated the November changelog. 9ebd550
v8.5.2 (2026-11-04)
Catalyst v8.5.2 — 2026-11-04
🚀 Features
- 🚀 Large index pages can use PostgreSQL planner row estimates instead of running an exact count query. Estimated totals display a
+suffix, andfast_countis available on ActiveRecord models and relations. #1767 (#austinjb32) - 🚀 File fields now support Active Storage direct uploads, with per-file progress and previews, so large files can upload outside the form submission request. #1745 (#austinjb32)
🐛 Bug Fixes
- 🐛 Aborted direct uploads now reject with
AbortErrorand prevent pending requests from being sent, avoiding uploads that otherwise remained unsettled or continued after cancellation. #1813 (#mikevic) - 🐛 Required single- and multi-file upload fields now validate correctly when no file is selected, including nested form fields. #1808 (#BrijeshSajeev)
- 🐛 Improved direct-upload handling across review-app domains and chat uploads, including URL resolution and upload guards. 1bcc808 · d6583d7 · b38d8e8
- 🐛 Added a tooltip during form submission. f3cea83
✨ Improvements
- ✨ Updated Bootstrap JavaScript, Popper, and vendored SCSS to compatible Bootstrap 5.3.8 versions, retaining Catalyst’s existing SCSS customizations. #1804 (#mikevic)
- ✨ File uploads now block form submission while uploading and are aborted when the drawer closes. 77c65d5
⚠️ Breaking Changes
No breaking changes in this release.
📚 Documentation
- 📚 Documented the
count_thresholdpagination setting andfast_count, including configuration examples, PostgreSQL behavior, and how to disable estimates. #1767 (#austinjb32) - 📚 Updated the November changelog with the v8.5.1 release notes. 24f1883
v8.5.1 (2026-11-02)
Catalyst v8.5.1 — 2026-11-02
🚀 Features
- 🚀 Added a
:stringfilter for text columns, withis,is_not,contains,does_not_contain,is_empty, andis_not_emptyconditions. String matches are case-insensitive, treat wildcard characters literally, and support custom filter scopes. #1751 (#anbublacky)
🐛 Bug Fixes
- 🐛 Corrected default-value handling for
:rangefilters and made empty dropdown selections behave as no filter. #1751 (#anbublacky)
✨ Improvements
- ✨ Standardized filter popup behavior: multi-select, range, and string filters now apply changes with the Apply button, Enter, or when the popup closes. Clear and Apply actions are shared across these popups. #1751 (#anbublacky)
- ✨ String filter conditions handle empty strings and
NULLrows as appropriate, with parameterized, case-insensitive matching. #1751 (#anbublacky)
⚠️ Breaking Changes
No breaking changes in this release.
📚 Documentation
- 📚 Updated the filter DSL reference and Advanced Filters and Custom Filter Method guides to document the
:stringtype, its supported conditions, and custom-scope usage. #1751 (#anbublacky)
v8.5.0 (2026-11-02)
Catalyst v8.5.0 — 2026-11-02
⚠️ WARNING: Breaking Changes — API token status is now derived from
expires_at, and theapi_tokens.statusdatabase column is removed. Generate and run the migration, and update customApiTokenmodels to derive status fromexpires_at.🔄 WARNING: Migration Required — Run these commands to generate and apply the migration:
rails generate cm_admin:remove_status_from_api_tokenrails db:migrate
🚀 Features
- 🔐 API tokens now respect
expires_atfor authentication and are reported as expired as soon as their expiry passes. Admins can set or extend token validity and expire live tokens from the API Token page. #1715 (#anbublacky)
🐛 Bug Fixes
- 🛡️ Token verification now rejects tokens whose expiry has passed, without depending on a background task to update a stored status. #1715 (#anbublacky)
✨ Improvements
- ✨
expires_atis now the single source of truth for token expiry. Thestatus,live?,expired?,livescope, andexpiredscope are derived from it, keeping model behavior and database queries consistent. #1787 (#mikevic) - ✨ The API Token “Expire” action now updates only
expires_at; expiry no longer needs a status-sync rake task or callbacks. #1787 (#mikevic)
⚠️ Breaking Changes
- ⚠️ Removed the
api_tokens.statuscolumn. Use thecm_admin:remove_status_from_api_tokengenerator, apply its migration, and update any customApiTokenmodel to derive status and expiry scopes fromexpires_at. The migration preserves manually expired tokens before dropping the column. #1787 (#mikevic)
📚 Documentation
- 📚 Updated the MCP setup example to omit the removed
statuscolumn and use an expiry-basedlivescope. Added generator documentation for removing API token status, including migration behavior and the model changes apps need to make. #1787 (#mikevic)
v8.4.3 (2026-11-02)
Catalyst v8.4.3 — 2026-11-02
🚀 Features
- 🚀 Added job listings and an application flow with job-specific questions, answer validation, and safeguards against duplicate applications. #1779 (#BrijeshSajeev)
- 🚀 Added selected-record counts and refreshed bulk-action controls on index and associated-index tables, with counts updating as selections change. #1753 (#anbublacky)
🐛 Bug Fixes
- 🐛 Bulk-action modals now show success and error banners together for partial success. Error details are escaped, failure counts are accurate, and custom error bodies replace the default message as intended. #1718 (#anbublacky)
- 🐛 Fixed fresh Rails 8.1 PostgreSQL app installation: generated migrations now create the expected tables with unique versions, and the installer completes database setup before copying the initializer. #1754 (#mikevic)
- 🐛 Fixed filter dropdown errors by pinning Popper to its production ESM build and removing the global
window.processshim. #1798 (#mikevic)
✨ Improvements
- 🛡️ Permission scopes are now enforced for record mutations as well as reads. Out-of-scope records cannot be changed through member actions, and create/update operations are checked against the applicable scope. #1775 (#BrijeshSajeev)
- ✨ Added the
ct_pathhelper to centralize per-model admin route generation and replace repeated dynamic route-helper calls. #1799 (#mikevic) - ✨ Consolidated repeated controller model lookups into a memoized helper without changing behavior. #1797 (#mikevic)
- ✨ Aligned test and review-app Ruby versions with the repository’s Ruby version file, updated the test workflow’s Node version source, and upgraded GitHub cache actions to v6. #1773 (#mikevic) #1790 (#mikevic) #1789 (#mikevic)
- ✨ Added Claude Code session setup and edit-formatting hooks, and a command allowlist to make cloud development and routine checks easier. #1791 (#mikevic) #1793 (#mikevic)
- ✨ Added
bin/cito run local lint checks and support the required signoff process. #1755 (#BrijeshSajeev)
⚠️ Breaking Changes
No breaking changes.
📚 Documentation
- 📚 Added a repository setup and testing guide for agents, documented signoff and linting steps, corrected stale workflow and spec references, and added a
CLAUDE.mdpointer toAGENTS.md. #1772 (#git-pranavr) #1785 (#mikevic) #1786 (#mikevic) #1784 (#mikevic) #1792 (#mikevic) - 📚 Updated the installer documentation to list the tables it creates, and updated the October 2026 changelog with the v8.4.2 release notes. #1754 (#mikevic) decf0f8c0