plan_my_stuff 0.21.0 → 0.21.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d33c652f54d9d078276d12baac63134e8bba4064185f61626c66fd924ea958a
-  data.tar.gz: 54f5c69130890fa5ae807d642cd8d89d2f0d74c4d12b638ed892d8f9b2df22d8
+  metadata.gz: 4eda8634e75b318cd847d512405f71d4ffe2b0d7a6beccd6404912a6c64f1c2b
+  data.tar.gz: 80c7edb2a0e861c3dc0f76b06ae23232bde0ed52d04f4cdada69bd29aa8107dd
 SHA512:
-  metadata.gz: 36d2a9a1624279d818d6c1a16fcfd51cd8e047e4f02d51044673fecb0ef3433b4a953290eb51deb868b9a8959fe365abf4dcb0645883466941047c6915c070d3
-  data.tar.gz: fbadf2e2e8337a7014e148e898291de7ef4453729332f2c8d2609942487ebec7359a97a687e44340edac1a0d7c8e36fdeddcd3cc90c8fe30a108f76f7ba74a49
+  metadata.gz: 3336630d6d5ee6b8bad51fdfa08a647aa58933e0f30a36241fd137a4d3f5b67656386d36fd0990d289499a7cf2643469e32c1642d4f2d5811be5fc671ea9d420
+  data.tar.gz: 15db293bc2203d60ca7e2b5d102035b1a8d064a74b84666e13d0fbcad1ab15dbe576f02af2f7582c56c9f65246dbb23e41043f6036e304801722c40890c463fc

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.21.1
+
+### Added
+
+- `config.eager_load_controllers_on_boot` (default `false`). When `true`, the engine eager-loads
+  `app/controllers/` in `after_initialize` so consuming apps with `eager_load = false` (dev mode) see
+  `PlanMyStuff::*Controller` constants without having to reference them first. Opt in if the host app
+  probes engine controllers via `defined?`, e.g. `defined?(PlanMyStuff::Issues::TakesController)` would
+  otherwise return `nil` until something triggered Zeitwerk autoload. Falls back to `Kernel#require` on
+  Zeitwerk < 2.6.2 (which lacks `eager_load_dir`).
+
 ## 0.21.0
 
 ### Breaking

data/CONFIGURATION.md

@@ -49,6 +49,19 @@ config.repo_nicknames = { safety: 'Compliance' } # :element -> "Element", :under
 `Issue#to_param` then returns `"Element-1234"` / `"Compliance-567"`, encoding both repo and number in a single
 URL segment so `youtrack_issue_path(@issue)` works without a `repo:` query param.
 
+## Attachments
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `attachment_repo` | `String` | `'pms-attachments'` | Bare repo (under `organization`) for uploaded attachments. |
+
+The repo must already exist; the uploader does not create it. Attachments commit onto
+`config.main_branch` under `<repo_key_or_name>/issue-<number>/<uuid>.<ext>`.
+
+```ruby
+config.attachment_repo = 'pms-attachments'
+```
+
 ## Projects
 
 | Option | Type | Default | Description |
@@ -337,6 +350,20 @@ config.cache_version = Rails.configuration.x.image_tag
 config.mount_groups = { webhooks: true, issues: true, projects: true }
 ```
 
+## Boot behavior
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `eager_load_controllers_on_boot` | `Boolean` | `false` | Eager-load engine controllers in `after_initialize`. |
+
+Opt in if the host app probes engine controllers via `defined?` in dev mode. When `true`, the
+engine walks `app/controllers` once on boot so `defined?(PlanMyStuff::SomeController)` resolves
+without first referencing the constant.
+
+```ruby
+config.eager_load_controllers_on_boot = true
+```
+
 ## Controller overrides
 
 | Option | Type | Default | Description |

data/lib/generators/plan_my_stuff/install/templates/initializer.rb

@@ -30,6 +30,15 @@ PlanMyStuff.configure do |config|
   # need an entry.
   # config.repo_nicknames = { safety: 'Compliance' }
 
+  # --------------------------------------------------------------------------
+  # Attachments
+  # --------------------------------------------------------------------------
+  # Bare repo name (under `organization`) that stores uploaded attachment
+  # binaries. The repo must already exist; the uploader does not create it.
+  # Attachments commit onto `config.main_branch` under
+  # `<repo_key_or_name>/issue-<number>/<uuid>.<ext>`.
+  # config.attachment_repo = 'pms-attachments'
+
   # --------------------------------------------------------------------------
   # Projects
   # --------------------------------------------------------------------------
@@ -184,6 +193,16 @@ PlanMyStuff.configure do |config|
   #
   # config.issue_fields_enabled = false
 
+  # --------------------------------------------------------------------------
+  # Boot behavior
+  # --------------------------------------------------------------------------
+  # Eager-load the engine's controllers in after_initialize so that
+  # `defined?(PlanMyStuff::SomeController)` resolves without first referencing
+  # the constant. Opt in if the host app probes engine controllers via
+  # `defined?` in dev mode.
+  #
+  # config.eager_load_controllers_on_boot = true
+
   # --------------------------------------------------------------------------
   # Release pipeline
   # --------------------------------------------------------------------------

data/lib/plan_my_stuff/configuration.rb

@@ -373,6 +373,15 @@ module PlanMyStuff
     #
     attr_accessor :issue_fields_enabled
 
+    # Whether to eager-load the engine's controllers on host boot. Defaults to +false+ (opt-in). When +true+, the engine
+    # walks +app/controllers+ during +after_initialize+ so +defined?(PlanMyStuff::SomeController)+ resolves without
+    # first referencing the constant. Enable in host apps that rely on +defined?+ probes against engine controllers in
+    # dev mode.
+    #
+    # @return [Boolean]
+    #
+    attr_accessor :eager_load_controllers_on_boot
+
     # @return [Configuration]
     def initialize
       @repos = {}
@@ -413,6 +422,7 @@ module PlanMyStuff
       @pipeline_completion_purge_enabled = true
       @pipeline_completion_ttl_hours = 24
       @issue_fields_enabled = true
+      @eager_load_controllers_on_boot = false
       @process_aws_webhooks = Rails.env.production?
       @sns_verifier_class = ::Aws::SNS::MessageVerifier if defined?(::Aws::SNS::MessageVerifier)
       @sns_verifier_error =

data/lib/plan_my_stuff/engine.rb

@@ -3,5 +3,21 @@
 module PlanMyStuff
   class Engine < ::Rails::Engine
     isolate_namespace PlanMyStuff
+
+    # Opt-in (via +config.eager_load_controllers_on_boot+): eager-load the engine's controllers regardless of the host
+    # app's eager_load setting. Without this, `defined?(PlanMyStuff::SomeController)` returns nil in host-app dev mode
+    # until something explicitly references the constant, since `defined?` does not trigger Zeitwerk autoload.
+    config.after_initialize do
+      next unless PlanMyStuff.configuration.eager_load_controllers_on_boot
+
+      controllers_dir = File.expand_path('../../app/controllers', __dir__)
+      loader = Rails.autoloaders.main
+
+      if loader.respond_to?(:eager_load_dir)
+        loader.eager_load_dir(controllers_dir)
+      else
+        Dir.glob(File.join(controllers_dir, '**/*.rb')).sort.each { |path| require path }
+      end
+    end
   end
 end

data/lib/plan_my_stuff/version.rb

@@ -4,7 +4,7 @@ module PlanMyStuff
   module VERSION
     MAJOR = 0
     MINOR = 21
-    TINY = 0
+    TINY = 1
 
     # Set PRE to nil unless it's a pre-release (beta, rc, etc.)
     PRE = nil

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: plan_my_stuff
 version: !ruby/object:Gem::Version
-  version: 0.21.0
+  version: 0.21.1
 platform: ruby
 authors:
 - Brands Insurance
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-20 00:00:00.000000000 Z
+date: 2026-05-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails