open_blog 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0473f44b17fe66c2fc03de0c142fa17bf8b139047b6b8ba1d5d9aff5bfe41a93
-  data.tar.gz: 5108c7a099c89c3353499bb2f719bc2e8fa67c9530cf34544e1fc0df11f79deb
+  metadata.gz: efdb8a5a4e6810822b5821360a7dafa544d704135f98ef877c226d7ae7888117
+  data.tar.gz: e15a793d38b597451baf0accb892cc5cb73ab4e86fa82fc90a04e6ea45807d9c
 SHA512:
-  metadata.gz: 21a997d93ee9f729af3ec4f14ebb287aca527d59cfa4f425c520156a19da7564f3f3c98c9680875f01afadfccf60fb1efc503a2a305f4274fab1cc75de06b11d
-  data.tar.gz: 31dbb1ca9b278348d3cc1405980db89649024b69788bc1983827dca9d8a998570389f96725be45edd83e7f92578cd7bdb2c0cdf2f20230737c2ba570d204ad2a
+  metadata.gz: a6554c741ba91b63ef85d001ea36f25b62aad3b351407a6e46fff323e79204a52aa7fbedd3837c114fb96548fc3b312236e8562fbb613d03c4ac0ec504ec6a12
+  data.tar.gz: 6cb4979aab3f7ea903759ff765c3a9843a7d917a9a1965241fcf2f9326c6dc7b338fe88e597e69248233e77d194254e7c0c2aeb71c325adeaa7840069cea55b5

data/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-10-28
+
+### Changed
+
+- Releases publish automatically. When a merged pull request changes the gem version and CI, Installer, and Docs pass on `main`, the Publish workflow pushes the gem to RubyGems and creates the GitHub Release from this changelog. The Prepare Release workflow is removed.
+- CI fails a pull request whose gem version has no dated changelog entry with notes.
+- The AdminSuite reload hook no longer raises `NoMethodError` on every code reload in development.
+
+## [0.3.1] - 2026-10-28
+
+### Changed
+
+- Allow JSON 3. The JSON requirement is now `>= 2.3, < 4`. Rails 8.1 hosts can use JSON 2 or 3.
+- On Rails 8.0 with JSON 3, Open Blog refuses to load with an `OpenBlog::ConfigurationError` that names the fix. Rails 8.0 passes `quirks_mode`, which JSON 3 rejects, so that pair does not work even without Open Blog.
+
+### Upgrade notes
+
+- On Rails 8.0, add `gem "json", "< 3"` to the Gemfile before `bundle update open_blog`, or upgrade to Rails 8.1. A new Rails 8.0 application installs JSON 3, so run `bundle add json --version "< 3"` before `bundle add open_blog`.
+
 ## [0.3.0] - 2026-10-20
 
 ### Added

data/README.md

@@ -61,6 +61,8 @@ bundle add open_blog
 bin/rails generate open_blog:install
 ```
 
+On Rails 8.0, run `bundle add json --version "< 3"` first. Rails 8.0 does not work with JSON 3, and Open Blog refuses to load on that pair.
+
 To run the latest unreleased source instead, use `bundle add open_blog --github techwright-lab/open-blog`.
 
 Start `bin/dev` (or `bin/rails server`) and open `/blog`. The generator installs tables, mounts the engine at `/blog`, copies the reader views and browser controllers, writes `config/initializers/open_blog.rb`, and publishes a sample article. If it prints an API token, save it: the secret is shown once.
@@ -129,7 +131,7 @@ The documentation is Markdown in `docs/`, built with Jekyll and Just the Docs fr
 
 ## Releases
 
-The **Prepare Release** workflow updates the version and changelog in a pull request. After review, merge, and successful checks, **Publish** publishes the verified package to RubyGems and creates or updates the GitHub Release. Merging ordinary changes does not publish a gem. See the [release guide](https://techwright-lab.github.io/open-blog/releases/) for the first-time Trusted Publishing setup.
+To release, change the version in `lib/open_blog/version.rb` and date its `CHANGELOG.md` section in a pull request. After the merge, when CI, Installer, and Docs pass on `main`, **Publish** publishes the package to RubyGems and creates the GitHub Release. Merging ordinary changes does not publish a gem. See the [release guide](https://techwright-lab.github.io/open-blog/releases/) for the first-time Trusted Publishing setup.
 
 ## License
 

data/lib/open_blog/admin_suite.rb

@@ -43,7 +43,7 @@ module OpenBlog
       ::AdminSuite::UI::FieldRendererRegistry.register(:open_blog_faq) do |view, form, field, resource, field_class|
         render_faqs(view, form, field, resource, field_class)
       end
-      Rails.application.reloader.to_prepare { install_controller! }
+      Rails.application.reloader.to_prepare { ::OpenBlog::AdminSuite.install_controller! }
       install_controller!
       @installed = true
     end

data/lib/open_blog/version.rb

@@ -1,3 +1,3 @@
 module OpenBlog
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/open_blog.rb

@@ -87,7 +87,16 @@ module OpenBlog
       end
       route ? route.path.spec.to_s : config.mount_path
     end
+
+    def require_supported_json!(rails: Rails.gem_version, json: Gem::Version.new(JSON::VERSION))
+      return if json < Gem::Version.new("3") || rails.release >= Gem::Version.new("8.1")
+
+      raise ConfigurationError, "JSON #{json} needs Rails 8.1 or later: Rails #{rails} passes quirks_mode, " \
+        'which JSON 3 rejects. Add gem "json", "< 3" to the Gemfile or upgrade Rails.'
+    end
   end
 end
 
+OpenBlog.require_supported_json!
+
 require_relative "open_blog/engine"

data/skills/open-blog-install/SKILL.md

@@ -19,7 +19,7 @@ For examples and explanations, read [host integration](https://techwright-lab.gi
 
 ## Install and configure
 
-Add a missing gem with `bundle add open_blog`, passing the requested version constraint when specified. For a fresh application, use `bin/rails generate open_blog:install`. For an existing application retaining its CSS pipeline, use `--skip-tailwind`. A staged local pilot can use:
+Add a missing gem with `bundle add open_blog`, passing the requested version constraint when specified. On Rails 8.0, first run `bundle add json --version "< 3"`; Open Blog refuses to load on Rails 8.0 with JSON 3. For a fresh application, use `bin/rails generate open_blog:install`. For an existing application retaining its CSS pipeline, use `--skip-tailwind`. A staged local pilot can use:
 
 ```sh
 bin/rails generate open_blog:install --theme=signal --skip-tailwind --skip-migrate --skip-sample
@@ -47,7 +47,7 @@ The controller stores `open-blog-theme` and sets `data-theme="light"` or `"dark"
 
 ## Upgrade copied files deliberately
 
-Read the target changelog, update any version constraint, then `bundle update open_blog --conservative`; review dependency changes too (Open Blog constrains JSON below 3). Bundler does not refresh copied host files.
+Read the target changelog, update any version constraint, then `bundle update open_blog --conservative`; review dependency changes too (on Rails 8.0, keep JSON below 3; Rails 8.1 can use JSON 3). Bundler does not refresh copied host files.
 
 `bin/rails generate open_blog:views` refreshes reader templates and `layouts/open_blog.html.erb` only. Compare controllers, locales, and theme sources with the installed package separately. Conflicting files are kept in a noninteractive rerun; a successful generator exit does not mean all copies are current. Merge required changes and use replacement only for reviewed files. A blanket `open_blog:install --force` also replaces the initializer. Review a host-owned layout against new helper/asset contracts manually. When moving from 0.1.0 to presets, replace old full-palette definitions with intentional overrides so they do not mask the new preset. Rebuild affected assets and restart.
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: open_blog
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - TechWright Labs
 bindir: bin
 cert_chain: []
-date: 2026-10-21 00:00:00.000000000 Z
+date: 2026-10-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -18,7 +18,7 @@ dependencies:
         version: '2.3'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '3'
+        version: '4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -28,7 +28,7 @@ dependencies:
         version: '2.3'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '3'
+        version: '4'
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement