plan_my_stuff 0.11.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a34c14adba5975eb4e685f1685c6f4e4cf860cb8013a30b529839de03f87cd19
-  data.tar.gz: ed239a56d7e52e6def2abd9e28929b49be7763945b84c3e3a4384ca2112f187c
+  metadata.gz: caa7ca14656d70850ad30923738ffa58177caf5fb91bd14bc6551f547590ca63
+  data.tar.gz: 1d4b79cc957efa2c146ffb2a433a90c798680b23da7b8907d9351b5cb041cc09
 SHA512:
-  metadata.gz: e779fe0ceff48e299512f96905e0e5b7e9e75b6047a4324b7657b77d4c2a2b21ba6e213d52d72feccb4477930327a3d3d3d9e89f5cb24f2c0502c6a256fd6ef4
-  data.tar.gz: e6242bd7a54f8861aca8d341ab17b569120c6acad8886e10b325f037b211b500939bbc941458a3756b54458bd43961588806129de9aa5718f8a99c6daa393f4d
+  metadata.gz: fd8f13707987c75445038cf93240be65897b00c538d3500665738554aa5ee3a6680352a2bb932e1fab41ba24e58985606655bd2f34e042375bc8a7692cde7310
+  data.tar.gz: 4b2160e17a7043004f294b7c6ae5c46f25f6a68ed5ca65ec5c3a124bfd34260521d1d07a6d22152e341f1d2ed8d6f1b79e729f6c9d39f8c7c0a907803baa017e

data/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## 0.13.0
+
+### Changed
+
+- Internal: gem now autoloads `lib/plan_my_stuff/**` via Zeitwerk
+  (already shipped by railties - no new dep). All `require_relative`
+  boilerplate in the gem's lib tree is gone. The gem entry retains two
+  explicit `require_relative`s for files that fall outside the autoload
+  model: `errors.rb` (defines several sibling error classes) and
+  `engine.rb` (must register with Rails at load time).
+
+## 0.12.0
+
+### Added
+
+- `PlanMyStuff::IssueField` for org-level GitHub Issue Field definitions (public preview).
+  Exposes `.list`, `.find` (case-insensitive), and `#option_id_for!` for resolving
+  single-select option names.
+- `PlanMyStuff::Issue#issue_fields` returns a hash-like `IssueFieldValueSet` view of the
+  field values on an issue. Values are coerced to native types (`Date` for date fields,
+  `Float` for numbers, the option name `String` for single-selects).
+- `PlanMyStuff::Issue#set_issue_fields!(updates)` writes one or more field values in a
+  single GraphQL mutation; passing `nil` as a value clears the field.
+- `issue_fields:` kwarg on `Issue.create!`, `Issue.update!`, `Issue#save!`, and
+  `Issue#update!` so callers can set field values inline with create/update instead of
+  following up with an explicit `set_issue_fields!` call.
+- `Configuration#issue_fields_enabled` (default `true`, opt-out). Set to `false` if your
+  org has not been admitted to the Issue Fields preview - with the flag off,
+  `Issue#issue_fields` returns an empty set and the write paths raise
+  `IssueFieldsNotEnabledError` instead of letting a raw GraphQL error surface.
+
 ## 0.11.0
 
 ### Added

data/CONFIGURATION.md

@@ -192,6 +192,26 @@ config.issue_types = {
 }
 ```
 
+## Issue Fields (public preview)
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `issue_fields_enabled` | `Boolean` | `true` | Whether the Issue Fields public preview is wired up for the org. |
+
+GitHub Issue Fields are structured per-issue metadata (text, number, date, or single-select)
+configured once at the org level. The preview is rolling out org-by-org. Leave this flag at its
+default (`true`) once your org has been admitted; flip to `false` to keep the gem from issuing
+calls that would otherwise return raw GraphQL errors.
+
+With the flag off:
+
+- `Issue#issue_fields` returns an empty `IssueFieldValueSet` without making a request.
+- `Issue#set_issue_fields!(...)` and `IssueField.list` raise `IssueFieldsNotEnabledError`.
+
+```ruby
+config.issue_fields_enabled = false   # org not admitted to the preview yet
+```
+
 ## Release pipeline
 
 | Option | Type | Default | Description |

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

@@ -168,6 +168,16 @@ PlanMyStuff.configure do |config|
   #   'Feature' => 'Enhancement',
   # }
 
+  # --------------------------------------------------------------------------
+  # Issue Fields (public preview)
+  # --------------------------------------------------------------------------
+  # GitHub Issue Fields is a per-org public preview. Default is true (opt-out).
+  # Flip to false if your org has not been admitted to the preview - read paths
+  # return an empty set and write paths raise IssueFieldsNotEnabledError instead
+  # of letting a raw GraphQL error bubble.
+  #
+  # config.issue_fields_enabled = false
+
   # --------------------------------------------------------------------------
   # Release pipeline
   # --------------------------------------------------------------------------

data/lib/plan_my_stuff/archive.rb

@@ -10,5 +10,3 @@ module PlanMyStuff
   module Archive
   end
 end
-
-require_relative 'archive/sweep'

data/lib/plan_my_stuff/base_project.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative 'base_project_extractions/graphql_hydration'
-
 module PlanMyStuff
   # Shared base for GitHub Projects V2 wrappers. Holds attribute definitions, generic find/list/update machinery,
   # hydration, and instance helpers. Concrete subclasses (Project, TestingProject) add their own +create!+ behavior

data/lib/plan_my_stuff/configuration.rb

@@ -356,6 +356,15 @@ module PlanMyStuff
     #
     attr_accessor :attachment_repo
 
+    # Whether GitHub's Issue Fields (public preview) are wired up for the configured org. Defaults to +true+ (opt-out):
+    # when +false+, +Issue#issue_fields+ returns an empty +IssueFieldValueSet+ without making a request and
+    # +Issue#set_issue_fields!+ / +IssueField.list+ raise +IssueFieldsNotEnabledError+. Set to +false+ if your org has
+    # not been admitted to the Issue Fields preview, to avoid raw GraphQL errors from GitHub.
+    #
+    # @return [Boolean]
+    #
+    attr_accessor :issue_fields_enabled
+
     # @return [Configuration]
     def initialize
       @repos = {}
@@ -394,6 +403,7 @@ module PlanMyStuff
       @archived_label = 'archived'
       @pipeline_completion_purge_enabled = true
       @pipeline_completion_ttl_hours = 24
+      @issue_fields_enabled = true
       @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/errors.rb

@@ -106,6 +106,17 @@ module PlanMyStuff
   class LockedIssueError < PlanMyStuff::Error
   end
 
+  # Raised when an Issue Fields API call is attempted while
+  # +config.issue_fields_enabled+ is +false+. Consumers whose org has not been
+  # admitted to the Issue Fields public preview flip the flag off; this error
+  # surfaces faster (and with a clearer message) than the underlying
+  # +GraphQLError+ that GitHub would otherwise return.
+  class IssueFieldsNotEnabledError < PlanMyStuff::Error
+    def initialize(message = nil)
+      super(message || 'Issue Fields are disabled; set config.issue_fields_enabled = true to enable')
+    end
+  end
+
   # Raised by +PlanMyStuff::Pipeline+ forward transitions when the linked
   # +Issue+ has any pending manager approvals.
   class PendingApprovalsError < PlanMyStuff::ValidationError

data/lib/plan_my_stuff/graphql/queries.rb

@@ -399,6 +399,56 @@ module PlanMyStuff
           }
         }
       GRAPHQL
+
+      # --- Issue Fields (org-level public preview) -----------------------
+
+      LIST_ORG_ISSUE_FIELDS = <<~GRAPHQL
+        query($org: String!) {
+          organization(login: $org) {
+            issueFields(first: 50) {
+              nodes {
+                __typename
+                ... on IssueFieldText         { id name description }
+                ... on IssueFieldNumber       { id name description }
+                ... on IssueFieldDate         { id name description }
+                ... on IssueFieldSingleSelect {
+                  id name description
+                  options { id name description color }
+                }
+              }
+            }
+          }
+        }
+      GRAPHQL
+
+      READ_ISSUE_FIELD_VALUES = <<~GRAPHQL
+        query($owner: String!, $name: String!, $number: Int!) {
+          repository(owner: $owner, name: $name) {
+            issue(number: $number) {
+              issueFieldValues(first: 50) {
+                nodes {
+                  __typename
+                  ... on IssueFieldTextValue         { value field { ... on IssueFieldText         { id name } } }
+                  ... on IssueFieldNumberValue       { value field { ... on IssueFieldNumber       { id name } } }
+                  ... on IssueFieldDateValue         { value field { ... on IssueFieldDate         { id name } } }
+                  ... on IssueFieldSingleSelectValue {
+                    name optionId
+                    field { ... on IssueFieldSingleSelect { id name } }
+                  }
+                }
+              }
+            }
+          }
+        }
+      GRAPHQL
+
+      SET_ISSUE_FIELD_VALUES = <<~GRAPHQL
+        mutation($issueId: ID!, $issueFields: [IssueFieldCreateOrUpdateInput!]!) {
+          setIssueFieldValue(input: { issueId: $issueId, issueFields: $issueFields }) {
+            issue { number }
+          }
+        }
+      GRAPHQL
     end
   end
 end

data/lib/plan_my_stuff/issue.rb

@@ -1,10 +1,5 @@
 # frozen_string_literal: true
 
-require_relative 'issue_extractions/approvals'
-require_relative 'issue_extractions/links'
-require_relative 'issue_extractions/viewers'
-require_relative 'issue_extractions/waiting'
-
 module PlanMyStuff
   # Wraps a GitHub issue with parsed PMS metadata and comments.
   # Class methods provide the public API for CRUD operations.
@@ -84,6 +79,9 @@ module PlanMyStuff
       # @param visibility_allowlist [Array<Integer>] user IDs for internal comment access
       # @param issue_type [String, nil] GitHub issue type name (e.g. +"Bug"+, +"Feature"+). Must match a type
       #   configured on the org. +nil+ creates the issue with no type.
+      # @param issue_fields [Hash{String,Symbol => Object,nil}, nil] GitHub Issue Field values to apply after the
+      #   issue is created. Delegates to +#set_issue_fields!+, so the same coercion rules and
+      #   +IssueFieldsNotEnabledError+ behavior apply. +nil+ or an empty hash is a no-op.
       # @param attachments [Array] files to upload to +config.attachment_repo+ and record on the body comment. Each
       #   entry may be an uploaded-file object responding to +#path+ and +#original_filename+ (e.g. Rails
       #   +ActionDispatch::Http::UploadedFile+), a String/Pathname path to a local file, or a pre-built
@@ -103,8 +101,13 @@ module PlanMyStuff
         visibility: 'public',
         visibility_allowlist: [],
         issue_type: nil,
+        issue_fields: nil,
         attachments: []
       )
+        if issue_fields.present? && !PlanMyStuff.configuration.issue_fields_enabled
+          raise(PlanMyStuff::IssueFieldsNotEnabledError)
+        end
+
         if body.blank?
           raise(PlanMyStuff::ValidationError.new('body must be present', field: :body, expected_type: :string))
         end
@@ -160,6 +163,8 @@ module PlanMyStuff
           attachments: attachments,
         )
 
+        issue.set_issue_fields!(issue_fields) if issue_fields.present?
+
         issue.reload
         PlanMyStuff::Notifications.instrument('issue.created', issue, user: user)
         issue
@@ -187,6 +192,9 @@ module PlanMyStuff
       # @param issue_type [String, nil] GitHub issue type name. Pass a String to set, +nil+ to clear, or omit the
       #   kwarg to leave the current type untouched. (+nil+-vs-omitted is differentiated by the private
       #   +ISSUE_TYPE_UNCHANGED+ sentinel.)
+      # @param issue_fields [Hash{String,Symbol => Object,nil}, nil] GitHub Issue Field values to apply after the
+      #   PATCH (or instead of it, when no other attrs are provided). Delegates to +#set_issue_fields!+, so the same
+      #   coercion rules and +IssueFieldsNotEnabledError+ behavior apply. +nil+ or an empty hash is a no-op.
       #
       # @return [Object]
       #
@@ -199,7 +207,8 @@ module PlanMyStuff
         labels: nil,
         state: nil,
         assignees: nil,
-        issue_type: ISSUE_TYPE_UNCHANGED
+        issue_type: ISSUE_TYPE_UNCHANGED,
+        issue_fields: nil
       )
         client = PlanMyStuff.client
         resolved_repo = client.resolve_repo!(repo)
@@ -236,7 +245,8 @@ module PlanMyStuff
 
         update_body_comment!(number, resolved_repo, body) if body
 
-        return if options.none?
+        updated_issue = find(number, repo: resolved_repo).set_issue_fields!(issue_fields) if issue_fields.present?
+        return updated_issue if options.none?
 
         result = client.rest(:update_issue, resolved_repo, number, **options)
         store_etag_to_cache(client, resolved_repo, number, result, cache_writer: :write_issue)
@@ -557,6 +567,7 @@ module PlanMyStuff
           visibility: metadata.visibility,
           visibility_allowlist: Array.wrap(metadata.visibility_allowlist),
           issue_type: issue_type,
+          issue_fields: @pending_issue_fields,
         )
         hydrate_from_issue(created)
       else
@@ -565,6 +576,7 @@ module PlanMyStuff
         instrument_update(captured_changes, user) unless skip_notification
       end
 
+      @pending_issue_fields = nil
       self
     end
 
@@ -666,6 +678,42 @@ module PlanMyStuff
       safe_read_field(github_response, :id)
     end
 
+    # Returns a hash-like view of GitHub Issue Field values currently set on this issue. Reads on first access and
+    # memoizes; +set_issue_fields!+ invalidates the cache. Returns an empty set without making a request when
+    # +config.issue_fields_enabled+ is +false+.
+    #
+    # @return [PlanMyStuff::IssueFieldValueSet]
+    #
+    def issue_fields
+      @issue_fields ||= load_issue_fields!
+    end
+
+    # Bulk-updates GitHub Issue Field values in a single +setIssueFieldValue+ mutation. Each key is the field display
+    # name; values are coerced to the right input fragment based on the field's type. Passing +nil+ as a value clears
+    # that field.
+    #
+    # @raise [PlanMyStuff::IssueFieldsNotEnabledError] when +config.issue_fields_enabled+ is +false+
+    # @raise [PlanMyStuff::Error] when a referenced field name does not exist on the org
+    #
+    # @param updates [Hash{String,Symbol => Object,nil}]
+    #
+    # @return [self]
+    #
+    def set_issue_fields!(updates)
+      raise(PlanMyStuff::IssueFieldsNotEnabledError) unless PlanMyStuff.configuration.issue_fields_enabled
+
+      fields_by_name = PlanMyStuff::IssueField.list(org: repo.organization).index_by { |field| field.name.downcase }
+      inputs = updates.map { |name, value| build_issue_field_input(fields_by_name, name, value) }
+
+      PlanMyStuff.client.graphql(
+        PlanMyStuff::GraphQL::Queries::SET_ISSUE_FIELD_VALUES,
+        variables: { issueId: github_node_id, issueFields: inputs },
+      )
+
+      @issue_fields = nil
+      self
+    end
+
     private
 
       # Populates this instance from a GitHub API response.
@@ -695,6 +743,7 @@ module PlanMyStuff
         @body_dirty = false
         persisted!
         @comments = nil
+        @issue_fields = nil
         invalidate_links_cache!
       end
 
@@ -722,6 +771,7 @@ module PlanMyStuff
         self.metadata = other.metadata
         persisted!
         @comments = nil
+        @issue_fields = nil
         invalidate_links_cache!
       end
 
@@ -764,6 +814,7 @@ module PlanMyStuff
         }
         attrs[:body] = body if @body_dirty
         attrs[:assignees] = @pending_assignees unless @pending_assignees.nil?
+        attrs[:issue_fields] = @pending_issue_fields if @pending_issue_fields.present?
         attrs[:issue_type] = issue_type if issue_type_changed?
 
         clear_waiting_state_on_close(attrs)
@@ -789,6 +840,7 @@ module PlanMyStuff
         self.body = attrs[:body] if attrs.key?(:body)
         self.issue_type = attrs[:issue_type] if attrs.key?(:issue_type)
         @pending_assignees = attrs[:assignees] if attrs.key?(:assignees)
+        @pending_issue_fields = attrs[:issue_fields] if attrs.key?(:issue_fields)
         apply_metadata_attrs(attrs[:metadata]) if attrs.key?(:metadata)
       end
 
@@ -905,5 +957,47 @@ module PlanMyStuff
 
         id
       end
+
+      # @return [PlanMyStuff::IssueFieldValueSet]
+      def load_issue_fields!
+        return PlanMyStuff::IssueFieldValueSet.new({}) unless PlanMyStuff.configuration.issue_fields_enabled
+
+        data = PlanMyStuff.client.graphql(
+          PlanMyStuff::GraphQL::Queries::READ_ISSUE_FIELD_VALUES,
+          variables: { owner: repo.organization, name: repo.name, number: number },
+        )
+        nodes = data.dig(:repository, :issue, :issueFieldValues, :nodes)
+        PlanMyStuff::IssueFieldValueSet.from_graphql(nodes)
+      end
+
+      # Builds one element of the +issueFields+ argument to the +setIssueFieldValue+ mutation. Looks up the field
+      # definition in the provided hash to pick the right input fragment and (for single-select) resolve the option ID.
+      #
+      # @raise [PlanMyStuff::Error] if the field name is unknown on the org
+      #
+      # @param fields_by_name [Hash{String => PlanMyStuff::IssueField}] fields keyed by downcased display name
+      # @param name [String, Symbol]
+      # @param value [Object, nil]
+      #
+      # @return [Hash]
+      #
+      def build_issue_field_input(fields_by_name, name, value)
+        field = fields_by_name[name.to_s.downcase]
+        raise(PlanMyStuff::Error, "Unknown Issue Field #{name.inspect}") if field.nil?
+
+        return { fieldId: field.id, delete: true } if value.nil?
+
+        case field.type
+        when :single_select then { fieldId: field.id, singleSelectOptionId: field.option_id_for!(value) }
+        when :date then { fieldId: field.id, dateValue: value.to_date.iso8601 }
+        when :number
+          unless value.is_a?(Numeric)
+            raise(PlanMyStuff::Error, "Issue Field #{name.inspect} expects Numeric, got #{value.inspect}")
+          end
+
+          { fieldId: field.id, numberValue: value.to_f }
+        when :text then { fieldId: field.id, textValue: value.to_s }
+        end
+      end
   end
 end

data/lib/plan_my_stuff/issue_field.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+module PlanMyStuff
+  # Value object wrapping an organization-level GitHub Issue Field definition (public preview).
+  # Issue Fields are structured per-issue metadata (text, number, date, or single-select)
+  # configured once at the org level and applied across all of the org's repositories.
+  #
+  # Read-only on the gem side: callers manage field *definitions* through the GitHub UI, while
+  # the gem only handles field *values* on individual issues (see +Issue#issue_fields+).
+  class IssueField
+    # GraphQL +__typename+ -> normalized type symbol used internally.
+    TYPES = {
+      IssueFieldText: :text,
+      IssueFieldNumber: :number,
+      IssueFieldDate: :date,
+      IssueFieldSingleSelect: :single_select,
+    }.freeze
+
+    # @return [String] GraphQL node ID, e.g. +"IFSS_kgDOAAGskA"+
+    attr_reader :id
+
+    # @return [String] display name (e.g. +"Priority"+)
+    attr_reader :name
+
+    # @return [Symbol] one of +:text+, +:number+, +:date+, +:single_select+
+    attr_reader :type
+
+    # @return [String, nil]
+    attr_reader :description
+
+    # @return [Array<Hash>] for +:single_select+, the option list as returned by GraphQL with symbol keys
+    #   (+id+, +name+, +description+, +color+). Empty for other field types.
+    attr_reader :options
+
+    class << self
+      # Lists Issue Field definitions configured on the org.
+      #
+      # @raise [PlanMyStuff::IssueFieldsNotEnabledError] if +config.issue_fields_enabled+ is +false+
+      #
+      # @param org [String, nil] org login; defaults to +config.organization+
+      #
+      # @return [Array<PlanMyStuff::IssueField>]
+      #
+      def list(org: nil)
+        ensure_enabled!
+
+        org_login = org || PlanMyStuff.configuration.organization
+        data = PlanMyStuff.client.graphql(
+          PlanMyStuff::GraphQL::Queries::LIST_ORG_ISSUE_FIELDS,
+          variables: { org: org_login },
+        )
+        Array.wrap(data.dig(:organization, :issueFields, :nodes)).map { |node| from_graphql(node) }
+      end
+
+      # @param name [String, Symbol]
+      # @param org [String, nil]
+      #
+      # @return [PlanMyStuff::IssueField, nil]
+      #
+      def find(name, org: nil)
+        list(org: org).find { |field| field.name.casecmp?(name.to_s) }
+      end
+
+      # @param node [Hash] one node from +LIST_ORG_ISSUE_FIELDS+
+      #
+      # @return [PlanMyStuff::IssueField]
+      #
+      def from_graphql(node)
+        typename = node[:__typename]
+        type = TYPES[typename.to_sym] if typename
+        raise(PlanMyStuff::Error, "Unknown Issue Field typename: #{typename.inspect}") if type.nil?
+
+        new(
+          id: node.fetch(:id),
+          name: node.fetch(:name),
+          type: type,
+          description: node[:description],
+          options: Array.wrap(node[:options]),
+        )
+      end
+
+      private
+
+        # @raise [PlanMyStuff::IssueFieldsNotEnabledError]
+        #
+        # @return [void]
+        #
+        def ensure_enabled!
+          return if PlanMyStuff.configuration.issue_fields_enabled
+
+          raise(PlanMyStuff::IssueFieldsNotEnabledError)
+        end
+    end
+
+    # @param id [String]
+    # @param name [String]
+    # @param type [Symbol]
+    # @param description [String, nil]
+    # @param options [Array<Hash>]
+    #
+    def initialize(id:, name:, type:, description: nil, options: [])
+      @id = id
+      @name = name
+      @type = type
+      @description = description
+      @options = options
+    end
+
+    # Resolves a single-select option name to its GraphQL node ID.
+    #
+    # @raise [PlanMyStuff::Error] if this field is not a single-select, or the option name is unknown
+    #
+    # @param option_name [String, Symbol]
+    #
+    # @return [String]
+    #
+    def option_id_for!(option_name)
+      raise(PlanMyStuff::Error, "Field #{name.inspect} is not a single-select") unless type == :single_select
+
+      match = options.find { |option| option.fetch(:name).casecmp?(option_name.to_s) }
+      raise(PlanMyStuff::Error, "Unknown option #{option_name.inspect} for field #{name.inspect}") if match.nil?
+
+      match.fetch(:id)
+    end
+  end
+end

data/lib/plan_my_stuff/issue_field_value_set.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module PlanMyStuff
+  # Hash-like read-side view of GitHub Issue Field values on a single +Issue+. Returned by
+  # +Issue#issue_fields+. Values are coerced into Ruby types on construction: date fields come back
+  # as +Date+, number fields as +Float+, single-select fields as the option name +String+, and
+  # text fields as the raw +String+.
+  #
+  # Access is by field display name; string and symbol keys both work. Iteration yields
+  # +[name, value]+ pairs in the order GitHub returned them.
+  class IssueFieldValueSet
+    include Enumerable
+
+    delegate :empty?, to: :@hash
+
+    class << self
+      # @param nodes [Array<Hash>, nil] +issueFieldValues.nodes+ from the GraphQL read query
+      #
+      # @return [PlanMyStuff::IssueFieldValueSet]
+      #
+      def from_graphql(nodes)
+        pairs = Array.wrap(nodes).map { |node| [node.dig(:field, :name), coerce(node)] }
+        new(pairs.to_h)
+      end
+
+      # @param node [Hash]
+      #
+      # @return [Object]
+      #
+      def coerce(node)
+        case node[:__typename].to_s
+        when 'IssueFieldDateValue' then Date.parse(node.fetch(:value))
+        when 'IssueFieldNumberValue' then node.fetch(:value).to_f
+        when 'IssueFieldSingleSelectValue' then node.fetch(:name)
+        else node.fetch(:value)
+        end
+      end
+    end
+
+    # @param hash [Hash{String => Object}]
+    #
+    def initialize(hash)
+      @hash = hash
+    end
+
+    # @param name [String, Symbol] field display name
+    #
+    # @return [Object, nil]
+    #
+    def [](name)
+      @hash[name.to_s]
+    end
+
+    # @return [Hash{String => Object}] copy of the underlying hash
+    def to_h
+      @hash.dup
+    end
+
+    # @return [Enumerator, void]
+    def each(&)
+      @hash.each(&)
+    end
+  end
+end

data/lib/plan_my_stuff/pipeline.rb

@@ -1,10 +1,5 @@
 # frozen_string_literal: true
 
-require_relative 'pipeline/completed_sweep'
-require_relative 'pipeline/issue_linker'
-require_relative 'pipeline/status'
-require_relative 'pipeline/testing'
-
 module PlanMyStuff
   # High-level orchestration layer for the release pipeline.
   #

data/lib/plan_my_stuff/reminders.rb

@@ -10,7 +10,3 @@ module PlanMyStuff
   module Reminders
   end
 end
-
-require_relative 'reminders/closer'
-require_relative 'reminders/fire'
-require_relative 'reminders/sweep'

data/lib/plan_my_stuff/version.rb

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

data/lib/plan_my_stuff.rb

@@ -1,48 +1,35 @@
 # frozen_string_literal: true
 
+require 'zeitwerk'
+
 require 'date'
 
 require 'active_support/core_ext/array/wrap'
 require 'active_support/core_ext/object/blank'
 
-require_relative 'plan_my_stuff/application_record'
-require_relative 'plan_my_stuff/approval'
-require_relative 'plan_my_stuff/archive'
-require_relative 'plan_my_stuff/attachment'
-require_relative 'plan_my_stuff/attachment_uploader'
-require_relative 'plan_my_stuff/base_metadata'
-require_relative 'plan_my_stuff/base_project'
-require_relative 'plan_my_stuff/base_project_item'
-require_relative 'plan_my_stuff/base_project_metadata'
-require_relative 'plan_my_stuff/cache'
-require_relative 'plan_my_stuff/client'
-require_relative 'plan_my_stuff/comment'
-require_relative 'plan_my_stuff/comment_metadata'
-require_relative 'plan_my_stuff/configuration'
-require_relative 'plan_my_stuff/custom_fields'
-require_relative 'plan_my_stuff/engine' if defined?(Rails)
+loader = Zeitwerk::Loader.for_gem
+loader.inflector.inflect(
+  'graphql' => 'GraphQL',
+  'version' => 'VERSION',
+)
+loader.ignore(
+  File.join(__dir__, 'generators'),
+  File.join(__dir__, 'tasks'),
+  File.join(__dir__, 'plan_my_stuff', 'aws_sns_simulator.rb'),
+  File.join(__dir__, 'plan_my_stuff', 'engine.rb'),
+  File.join(__dir__, 'plan_my_stuff', 'errors.rb'),
+  File.join(__dir__, 'plan_my_stuff', 'test_helpers.rb'),
+  File.join(__dir__, 'plan_my_stuff', 'webhook_replayer.rb'),
+)
+loader.setup
+
+# errors.rb defines several sibling error classes - load it eagerly rather
+# than rely on autoload-via-lead-constant.
 require_relative 'plan_my_stuff/errors'
-require_relative 'plan_my_stuff/graphql/queries'
-require_relative 'plan_my_stuff/issue'
-require_relative 'plan_my_stuff/issue_metadata'
-require_relative 'plan_my_stuff/label'
-require_relative 'plan_my_stuff/link'
-require_relative 'plan_my_stuff/markdown'
-require_relative 'plan_my_stuff/metadata_parser'
-require_relative 'plan_my_stuff/notifications'
-require_relative 'plan_my_stuff/pipeline'
-require_relative 'plan_my_stuff/project'
-require_relative 'plan_my_stuff/project_item'
-require_relative 'plan_my_stuff/project_item_metadata'
-require_relative 'plan_my_stuff/project_metadata'
-require_relative 'plan_my_stuff/reminders'
-require_relative 'plan_my_stuff/repo'
-require_relative 'plan_my_stuff/testing_project'
-require_relative 'plan_my_stuff/testing_project_item'
-require_relative 'plan_my_stuff/testing_project_metadata'
-require_relative 'plan_my_stuff/user_resolver'
-require_relative 'plan_my_stuff/verifier'
-require_relative 'plan_my_stuff/version'
+
+# Engine must register with Rails at load time, so eagerly require it
+# (and only when Rails is defined - otherwise Rails::Engine is undefined).
+require_relative 'plan_my_stuff/engine' if defined?(Rails)
 
 module PlanMyStuff
   class << self

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: plan_my_stuff
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Brands Insurance
@@ -132,6 +132,8 @@ files:
 - lib/plan_my_stuff/issue_extractions/links.rb
 - lib/plan_my_stuff/issue_extractions/viewers.rb
 - lib/plan_my_stuff/issue_extractions/waiting.rb
+- lib/plan_my_stuff/issue_field.rb
+- lib/plan_my_stuff/issue_field_value_set.rb
 - lib/plan_my_stuff/issue_metadata.rb
 - lib/plan_my_stuff/label.rb
 - lib/plan_my_stuff/link.rb