comfy_middle_seat 3.2.1 → 4.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4b2154b0c5ddc39354f9407955841c380dd85c70f4f3cbcddcf3e11fbefa352
-  data.tar.gz: '06858e762e783ff3862dd9400acc853f8e1481e6fc52098294ba40f2afeea65c'
+  metadata.gz: c2b743bb8f3cdbae17801963c031a890072c7b4694336e155dd0d381a49ec2ff
+  data.tar.gz: c73a92f4aa40a06760914731d40cd0c9f7471b5abf20aa3710f522d300353f84
 SHA512:
-  metadata.gz: c892bc46404adb3d6573811baf8a7406dfe85bb8251a6954b2a5ecec043872bc818aa4cc2c67ab925bf3f0170cc8afc8a112d0341ea64a8f4e623a5f993b7fd2
-  data.tar.gz: 1e1be00b0b164a6e0120694508752af5cf1d0cc4d60acf8e2c1b099229274a40a82968e94076b7535e86008e167ac581da32354e5400320804036ecbcef719bc
+  metadata.gz: edd044c383fafb4c9c310df6c83e35f365fa5aeac4052f844f0fd8051a89b1b63564af6ad6ddc5a12637a866b700f34ce3342d077ca9e54dacf20b35a3ccec2a
+  data.tar.gz: 204fac7b1e4c2b3bfc3677529fede906334ffe97cdda1180a24c19a40c6b8175b0a13e6635b2d5d1ad78cb87e9fdd1c62c604f057f28193ca23065d6375b3374

data/CHANGELOG.md

@@ -12,10 +12,26 @@ This changelog follows the project's lineage: **Comfortable Mexican Sofa → Com
 
 ## [Unreleased]
 
+### Changed
+
+- Complete the implementation namespace and internal-path decoupling from Comfortable Media Surfer: current Ruby APIs now use `ComfyMiddleSeat`, library files live under `comfy_middle_seat`, and generated configuration belongs at `config/initializers/comfy_middle_seat.rb`.
+- Require applications upgrading from `comfortable_media_surfer` to rename the initializer and replace Ruby configuration or integration references from `ComfortableMediaSurfer` to `ComfyMiddleSeat`. The existing `comfy_cms_*` database tables, schema, and stored data remain unchanged, so no database migration is required.
+- Add the standalone `comfy-middle-seat-upgrade` executable to safely preview and convert a legacy initializer without booting Rails, preserving the original as a backup and refusing ambiguous or destructive changes.
+- Preserve Comfortable Media Surfer names and URLs where they describe project history, acknowledgements, inherited release notes, or upstream resources rather than the current API.
+
+## [v3.2.1] - 2026-09-17
+
 ### Fixed
 
 - Fix CI eager loading after the gem rename by excluding the explicitly required `comfy_middle_seat` entrypoint and version directory from Zeitwerk autoloading. Add a regression test that also checks eager loading outside CI.
 
+### Changed
+
+- At the time of this release, update the admin footer branding and repository link to Comfy Middle Seat while retaining the then-current `ComfortableMediaSurfer::VERSION` compatibility constant.
+- Check that `COVERALLS_REPO_TOKEN` is configured before running the coverage job, with a clear error when it is missing.
+- Document asset compilation and explicit test database setup, along with commands for running the main and browser/system test suites.
+- Update README badges and release documentation, preserving the distinction between Seat releases and inherited Surfer history.
+
 ## [v3.2.0] - 2026-09-17
 
 **First Comfy Middle Seat release.** Forked from [Comfortable Media Surfer](https://github.com/shakacode/comfortable-media-surfer), itself a revival of [Comfortable Mexican Sofa](https://github.com/comfy/comfortable-mexican-sofa). The new name keeps the C.M.S. initials and pays homage to the original.
@@ -23,7 +39,7 @@ This changelog follows the project's lineage: **Comfortable Mexican Sofa → Com
 ### Changed
 
 - Publish the gem as `comfy_middle_seat` and rename the gemspec to `comfy_middle_seat.gemspec`.
-- Preserve the `ComfortableMediaSurfer` Ruby namespace, configuration, routes, and database tables. Existing Surfer applications do not need a namespace or schema migration for the rename.
+- At the time of v3.2.0, preserve the `ComfortableMediaSurfer` Ruby namespace and configuration while retaining the existing routes and database tables. The Unreleased namespace decoupling supersedes the Ruby compatibility behavior; the database compatibility remains unchanged.
 - Move the version definition to `lib/comfy_middle_seat/version.rb` for release tooling, retaining a compatibility loader at the old path.
 - Run the main test suite in six isolated processes by default, with merged coverage and a separate `test:serial` task for Coveralls.
 - Update CI coverage to Rails 7.2, 8.0, and 8.1, with a separate browser/system test job.
@@ -39,9 +55,9 @@ This changelog follows the project's lineage: **Comfortable Mexican Sofa → Com
 - Fix file modal cleanup and reinitialization, and expose jQuery for Bootstrap integration.
 - Remove the unsupported `:escape` option before JSON parsing while preserving other parser options.
 
-### Upgrading from Surfer
+### Historical v3.2.0 upgrade behavior
 
-Replace `comfortable_media_surfer` with `comfy_middle_seat` in your Gemfile and run `bundle install`. Do not include both gems. Keep existing `ComfortableMediaSurfer` configuration and initializer names.
+For v3.2.0, users replaced `comfortable_media_surfer` with `comfy_middle_seat` in the Gemfile while keeping the former Ruby namespace and initializer name. That release-specific compatibility guidance is preserved for history but is superseded by the Unreleased change: current upgrades must rename the initializer to `config/initializers/comfy_middle_seat.rb` and replace `ComfortableMediaSurfer` Ruby references with `ComfyMiddleSeat`. Neither stage changes the database schema.
 
 ## Comfortable Media Surfer — inherited releases
 
@@ -170,7 +186,8 @@ First release of `comfortable_media_surfer`. This new gem is a revival of [Comfo
 
 - Rebranded **ComfortableMexicanSofa** as **ComfortableMediaSurfer** in order to publish new gem (database table names and schema have not changed).
 
-[Unreleased]: https://github.com/avonderluft/comfy-middle-seat/compare/v3.2.0...master
+[Unreleased]: https://github.com/avonderluft/comfy-middle-seat/compare/v3.2.1...master
+[v3.2.1]: https://github.com/avonderluft/comfy-middle-seat/compare/v3.2.0...v3.2.1
 [v3.2.0]: https://github.com/avonderluft/comfy-middle-seat/compare/eeb5d590f47b5d6bb70191fb81c781540753fa97...v3.2.0
 [v3.1.7]: https://github.com/shakacode/comfortable-media-surfer/compare/v3.1.6...v3.1.7
 [v3.1.6]: https://github.com/shakacode/comfortable-media-surfer/compare/v3.1.5...v3.1.6

data/CONTRIBUTING.md

@@ -1,10 +1,10 @@
 # Contributing
 
-Contribute your code to ComfortableMediaSurfer in 5 easy steps:
+Contribute to [Comfy Middle Seat](https://github.com/avonderluft/comfy-middle-seat) in five steps:
 
 ### 1. Fork it
 
-Fork the project. Optionally, create a branch you want to work on.
+Fork the [current repository](https://github.com/avonderluft/comfy-middle-seat). Optionally, create a branch for your work.
 
 ### 2. Get it running locally
 
@@ -25,9 +25,12 @@ Fork the project. Optionally, create a branch you want to work on.
 
 ### 3. Hack away
 
-- Create a few small pull requests instead of a humoungous one. I can merge small stuff faster.
-- When adding new code just make sure it follows the same style as the existing code.
-- Avoid adding 3rd party dependencies if you can.
+- Use the current `ComfyMiddleSeat` Ruby namespace and `comfy_middle_seat` internal paths. New configuration examples and generated initializers belong in `config/initializers/comfy_middle_seat.rb`; do not reintroduce `ComfortableMediaSurfer` as a current API.
+- Keep the existing `comfy_cms_*` database tables and schema stable. The namespace and internal-path decoupling does not require a database migration.
+- Historical release notes, acknowledgements, and upstream links may intentionally retain the Comfortable Media Surfer name.
+- Create a few small pull requests instead of one huge pull request. Smaller changes can be reviewed and merged faster.
+- When adding new code, make sure it follows the same style as the existing code.
+- Avoid adding third-party dependencies if you can.
 - Tests please, but nothing complicated. UnitTest / Fixtures all the way. Make sure all tests pass.
 - Run `bundle exec rubocop` and fix any issues raised.
 

data/Gemfile

@@ -26,7 +26,7 @@ end
 group :test do
   gem 'brakeman'
   gem 'bundler-audit',            '~> 0.9.1'
-  gem 'coveralls_reborn',         '~> 0.29.0', require: false
+  gem 'coveralls_reborn',         require: false
   gem 'cuprite',                  '>= 0.15'
   gem 'diffy'
   gem 'equivalent-xml',           '~> 0.6.0'

data/README.md

@@ -1,17 +1,19 @@
-[![Rails CI](https://github.com/avonderluft/comfortable-media-surfer/actions/workflows/rubyonrails.yml/badge.svg)](https://github.com/avonderluft/comfortable-media-surfer/actions/workflows/rubyonrails.yml) [![Test Coverage](https://img.shields.io/coverallsCoverage/github/avonderluft/comfy-middle-seat?branch=master&cacheSeconds=300)](https://coveralls.io/github/avonderluft/comfy-middle-seat?branch=master) [![Gem Version](https://img.shields.io/gem/v/comfy_middle_seat.svg?style=flat)](https://rubygems.org/gems/comfy_middle_seat) [![Gem Downloads](https://img.shields.io/gem/dt/comfy_middle_seat.svg?style=flat)](https://rubygems.org/gems/comfy_middle_seat) [![GitHub Release Date - Published_At](https://img.shields.io/github/release-date/avonderluft/comfy-middle-seat?label=last%20release&color=seagreen)](https://github.com/avonderluft/comfortable-media-surfer/releases)
+[![Rails CI](https://github.com/avonderluft/comfy-middle-seat/actions/workflows/rubyonrails.yml/badge.svg)](https://github.com/avonderluft/comfy-middle-seat/actions/workflows/rubyonrails.yml) [![Test Coverage](https://img.shields.io/coverallsCoverage/github/avonderluft/comfy-middle-seat?branch=master&cacheSeconds=300)](https://coveralls.io/github/avonderluft/comfy-middle-seat?branch=master) [![Gem Version](https://img.shields.io/gem/v/comfy_middle_seat.svg?style=flat)](https://rubygems.org/gems/comfy_middle_seat) [![Gem Downloads](https://img.shields.io/gem/dt/comfy_middle_seat.svg?style=flat)](https://rubygems.org/gems/comfy_middle_seat) [![GitHub Release Date - Published_At](https://img.shields.io/github/release-date/avonderluft/comfy-middle-seat?label=last%20release&color=seagreen)](https://github.com/avonderluft/comfy-middle-seat/releases)
 
 # Comfy Middle Seat
 
-Comfy Middle Seat is a Rails CMS (Content Management System) engine, published as gem `comfy_middle_seat`. It retains the Comfortable Media Surfer implementation and pays homage to the original Comfortable Mexican Sofa—with the same C.M.S. initials and a new place to sit.
+It all depends on who is sitting on your left and on your right.
 
-The `ComfortableMediaSurfer` Ruby namespace, configuration, and internal paths remain unchanged. Only the gem's public name changes; there is no need to rename existing Surfer initializers or database tables.
+Comfy Middle Seat is a Rails CMS (Content Management System) engine, published as the `comfy_middle_seat` gem. It is descended from Comfortable Media Surfer and pays homage to the original Comfortable Mexican Sofa—with the same C.M.S. initials with a new place to sit.
+
+The current implementation uses the `ComfyMiddleSeat` Ruby namespace, `comfy_middle_seat` internal paths, and the initializer `config/initializers/comfy_middle_seat.rb`. Database storage remains compatible: the existing `comfy_cms_*` tables and schema are unchanged, so this namespace change requires no database migration.
 
 ## Project History
 
 - **[Comfortable Mexican Sofa](https://github.com/comfy/comfortable-mexican-sofa)**, created by Oleg Khabarov, is the original Rails CMS on which this project is built.  Oleg deserves the lion's share of kudos.
-- **[Occams](https://github.com/avonderluft/occams)** was an attempted revival of Sofa. Andrew vonderLuft was a contributor to [RadiantCMS](https://github.com/radiant/radiant) back in the day, but that project became inactive. He found Sofa and liked it even better than Radiant, but sadly it too became inactive. Hence Occams.
-- **[Comfortable Media Surfer](https://github.com/shakacode/comfortable-media-surfer)** revived Sofa under the sponsor ship of ShakaCode, continuing its development for modern Rails applications.
-- **Comfy Middle Seat** is a fork of Comfortable Media Surfer, published with a new gem name while retaining the Surfer implementation and API.
+- **[oCcaMS](https://github.com/avonderluft/occams)** was an attempted revival of Sofa. Andrew vonderLuft was a contributor to [RadiantCMS](https://github.com/radiant/radiant) back in the day, but that project became inactive. He found Sofa and liked it even better than Radiant, but sadly it too became inactive. Hence Occams.
+- **[Comfortable Media Surfer](https://github.com/shakacode/comfortable-media-surfer)** revived Sofa under the sponsorship of ShakaCode, continuing its development for modern Rails applications.
+- **[Comfy Middle Seat](https://github.com/avonderluft/comfy-middle-seat)** began as a fork of Comfortable Media Surfer and is now implemented under its own `ComfyMiddleSeat` namespace and `comfy_middle_seat` paths.
 
 See the [CHANGELOG](CHANGELOG.md) for the inherited development history, and the original [Sofa releases](https://github.com/comfy/comfortable-mexican-sofa/releases) and [Surfer releases](https://github.com/shakacode/comfortable-media-surfer/releases) for earlier releases.
 
@@ -44,15 +46,17 @@ Add gem definition to your Gemfile:
 gem "comfy_middle_seat", "~> 3.2.0"
 ```
 
-Then from the Rails project's root run:
+Then, for a new installation, run these commands from the Rails project's root:
 
-```
-    bundle install
-    rails generate comfy:cms
-    rails db:migrate
-    rails comfy:compile_assets
+```sh
+bundle install
+rails generate comfy:cms
+rails db:migrate
+rails comfy:compile_assets
 ```
 
+`rails db:migrate` is part of a new installation. Applications upgrading from Comfortable Media Surfer already have the same tables and schema and do not need a database migration for the gem, namespace, or internal-path rename.
+
 Now take a look inside your `config/routes.rb` file. You'll see where routes attach for the admin area and content serving. Make sure that content serving route appears as a very last item or it will make all other routes to be inaccessible.
 
 ```ruby
@@ -60,24 +64,60 @@ comfy_route :cms_admin, path: "/admin"
 comfy_route :cms, path: "/"
 ```
 
+The generator creates `config/initializers/comfy_middle_seat.rb`. Use `ComfyMiddleSeat` for configuration and other library API references:
+
+```ruby
+ComfyMiddleSeat.configure do |config|
+  config.cms_title = "My CMS"
+  config.admin_base_controller = "ApplicationController"
+end
+
+ComfyMiddleSeat::AccessControl::AdminAuthentication.username = "user"
+ComfyMiddleSeat::AccessControl::AdminAuthentication.password = "change-me"
+```
+
 ## Converting from Comfortable Media Surfer, Comfortable Mexican Sofa, or Occams
 
 ### From Surfer to Middle Seat
 
-Replace `comfortable_media_surfer` in your Gemfile with `comfy_middle_seat` and run `bundle install`. Do not include both gems. Existing `ComfortableMediaSurfer` configuration and database tables remain unchanged.
+1. Replace `comfortable_media_surfer` in your Gemfile with `comfy_middle_seat` and run `bundle install`. Do not include both gems.
+2. From the Rails application root, preview and run the standalone initializer upgrader. It does not boot Rails:
+
+   ```sh
+   bundle exec comfy-middle-seat-upgrade --dry-run
+   bundle exec comfy-middle-seat-upgrade
+   ```
+
+   It renames `config/initializers/comfortable_media_surfer.rb` to `config/initializers/comfy_middle_seat.rb`, updates the project namespace references inside it, and preserves the original as `config/initializers/comfortable_media_surfer.rb.bak`. It refuses to overwrite an existing initializer or backup.
+3. In any other application integrations, replace Ruby references to `ComfortableMediaSurfer` with `ComfyMiddleSeat`.
+
+For example:
+
+```ruby
+# Before
+ComfortableMediaSurfer.configure do |config|
+  config.cms_title = "My CMS"
+end
+
+# After
+ComfyMiddleSeat.configure do |config|
+  config.cms_title = "My CMS"
+end
+```
+
+Review the converted initializer and remove its `.bak` file when satisfied. The database tables, schema, and stored records remain unchanged; existing `comfy_cms_*` tables are used as-is, and **no database migration is required** for this upgrade.
 
 ### From Sofa to Middle Seat
 
-The database structure is the same.  Your Sofa project will also need to be upgraded to >= Rails 7.2  
-Then you should simply be able to update your Gemfile thus, and run bundle
+The database structure is the same, so no database migration is required for the CMS tables. Your Sofa project must first be upgraded to Rails 7.2 or newer. Then update the Gemfile, run `bundle install`, use `config/initializers/comfy_middle_seat.rb`, and update CMS library references in application code to `ComfyMiddleSeat`:
 
 ```ruby
-gem 'comfy_middle_seat', '~> 3.2.0'
+gem "comfy_middle_seat", "~> 3.2.0"
 ```
 
 ### From Occams to Middle Seat
 
-Again the project must be >= Rails 7.2.  Since the schema is different, executing this SQL should get you set for Middle Seat
+The project must be on Rails 7.2 or newer. Unlike Surfer and Sofa, Occams used different table names, so converting an Occams database requires the following SQL. This is an Occams data conversion, not a migration caused by the current `ComfyMiddleSeat` namespace or internal-path change.
 
 ```sql
 ALTER TABLE occams_cms_categories RENAME TO comfy_cms_categories;
@@ -105,7 +145,7 @@ UPDATE active_storage_attachments SET record_type = 'Comfy::Cms::File' WHERE rec
 
 After finishing installation you should be able to navigate to http://localhost:3000/admin
 
-Default username and password is 'user' and 'pass'. You probably want to change it right away. Admin credentials (among other things) can be found and changed in your app's CMS initializer: `config/initializers/comfortable_media_surfer.rb`. The initializer retains its Surfer name for compatibility.
+The default username and password are `user` and `pass`. Change them before exposing the application. Admin credentials and other CMS settings are configured in `config/initializers/comfy_middle_seat.rb` through the `ComfyMiddleSeat` namespace.
 
 Before creating pages and populating them with content we need to create a Site. Site defines a hostname, content path and its language.
 
@@ -124,7 +164,7 @@ Once you have a layout, you may start creating pages and populating content. It'
 
 ## Documentation
 
-The [Comfortable Media Surfer Wiki](https://github.com/shakacode/comfortable-media-surfer/wiki) remains the upstream reference for the inherited CMS features, including [Content Tags](https://github.com/shakacode/comfortable-media-surfer/wiki/Docs:-Content-Tags). The feature links above also point to that wiki. When following its installation instructions, use the `comfy_middle_seat` gem; Ruby examples using `ComfortableMediaSurfer` retain that namespace.
+The [Comfortable Media Surfer Wiki](https://github.com/shakacode/comfortable-media-surfer/wiki) remains an upstream reference for inherited CMS features, including [Content Tags](https://github.com/shakacode/comfortable-media-surfer/wiki/Docs:-Content-Tags). These historical upstream links are intentionally preserved. When adapting its examples, use the `comfy_middle_seat` gem, `config/initializers/comfy_middle_seat.rb`, and the `ComfyMiddleSeat` Ruby namespace; upstream examples that use `ComfortableMediaSurfer` show the former API and must be updated.
 
 ## Add-ons
 
@@ -136,7 +176,7 @@ If you want to add a Blog functionality to your app take a look at
 
 #### Contributing
 
-Comfy Middle Seat can run like any Rails application in development. It's as easy to work on as any other Rails app. For more detail see [CONTRIBUTING](CONTRIBUTING.md). The inherited development instructions may still refer to Comfortable Media Surfer.
+Comfy Middle Seat can run like any Rails application in development. It's as easy to work on as any other Rails app. For more detail, see [CONTRIBUTING](CONTRIBUTING.md).
 
 #### Testing
 

data/Rakefile

@@ -8,7 +8,7 @@ require 'stringio'
 
 Rails.application.load_tasks
 
-module ComfortableMediaSurferTestOutput
+module ComfyMiddleSeatTestOutput
   SUMMARY = %r{(?<assertions>\d+) assertions, (?<errors>\d+) errors, (?<failures>\d+) failures, (?<skips>\d+) skips?, (?<tests>\d+) tests}
   COLORS = { green: 32, yellow: 33, red: 31, cyan: 36 }.freeze
 
@@ -71,7 +71,7 @@ module ComfortableMediaSurferTestOutput
     def flush
       return if @pending.empty?
 
-      @io.print ComfortableMediaSurferTestOutput.progress_color(@pending)
+      @io.print ComfyMiddleSeatTestOutput.progress_color(@pending)
       @io.flush
       @pending.clear
     end
@@ -197,7 +197,7 @@ namespace :test do
   Rake::Task['test:serial'].enhance(['test:prepare_serial'])
 
   desc 'Run tests in isolated processes'
-  task(:parallel) { ComfortableMediaSurferTestOutput.run_parallel }
+  task(:parallel) { ComfyMiddleSeatTestOutput.run_parallel }
 end
 
 Rake::Task[:test].clear

data/app/assets/javascripts/comfy/admin/cms/application.js

@@ -15,6 +15,7 @@ import "./base";
 import "./categories";
 import "./codemirror";
 import "./diff";
+import "./draft_forms";
 import "./file_link";
 import "./file_upload";
 import "./files_modal";

data/app/assets/javascripts/comfy/admin/cms/base.js

@@ -25,15 +25,18 @@
     CMS.wysiwyg.init();
     CMS.sortableList.init();
     CMS.timepicker.init();
-    CMS.pageFragments();
+    CMS.pageFragments.init();
     CMS.categories();
     CMS.files.init();
     CMS.fileLinks();
     CMS.fileUpload.init();
     CMS.diff();
+    CMS.draftForms.init();
   };
 
   CMS.dispose = () => {
+    CMS.pageFragments.dispose();
+    CMS.draftForms.dispose();
     CMS.codemirror.dispose();
     CMS.wysiwyg.dispose();
     CMS.files.dispose();

data/app/assets/javascripts/comfy/admin/cms/codemirror.js

@@ -18,6 +18,9 @@ import "codemirror/mode/htmlmixed/htmlmixed";
           lineNumbers: true,
           viewportMargin: Infinity,
         });
+        codemirror.on("change", () => {
+          textarea.dispatchEvent(new Event("input", { bubbles: true }));
+        });
         codeMirrorInstances.push(codemirror);
       }
 
@@ -33,6 +36,20 @@ import "codemirror/mode/htmlmixed/htmlmixed";
           }
         });
     },
+    sync(root = document) {
+      for (const codemirror of codeMirrorInstances) {
+        if (root.contains(codemirror.getTextArea())) codemirror.save();
+      }
+    },
+    restore(root = document) {
+      for (const codemirror of codeMirrorInstances) {
+        const textarea = codemirror.getTextArea();
+        if (!root.contains(textarea)) continue;
+
+        codemirror.setValue(textarea.value);
+        codemirror.refresh();
+      }
+    },
     dispose() {
       for (const codemirror of codeMirrorInstances) {
         codemirror.toTextArea();