ecoportal-api-graphql 1.3.16 → 2.0.0

data/lib/ecoportal/api/graphql/input/workflow_command/edit_template_container_uid.rb

@@ -0,0 +1,45 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          # `WorkflowEditTemplateContainerUidInput { templateContainerUid: String! }`.
+          #
+          # Sets the template's CROSS-VERSION identity key. Semantics (verified against the
+          # backend on 2026-07-31 — see `.ai-assistance/code/ecoPortal_architecture/02_data_model.md`):
+          #
+          # - Format `/\A[a-zA-Z0-9\-_.]{3,20}\z/` — org-scoped, human-authored.
+          # - Many versions of a template may share one uid, but only ONE may be published
+          #   (`active: true`, unarchived) per organization at a time. Publishing another with
+          #   the same uid UNPUBLISHES the incumbent (a swap, not an error), which is what stops
+          #   restored UAT backups from colliding with the live PROD template.
+          # - Rejected with `:template_container_uid, :taken` when the swap is not permitted.
+          # - Requires `Pages::TemplatePolicy#change_template_container_uid?`
+          #   (`required_level: :implement`).
+          #
+          # The value is REQUIRED and non-null in the schema, so nil is rejected here rather
+          # than silently dropped — `.compact` (as used by the sibling builders) would emit an
+          # empty command that the server rejects with a less obvious message.
+          module EditTemplateContainerUid
+            SCHEMA_VERSION = '20260731'.freeze
+            VALID_KEYS = %i[templateContainerUid].freeze
+            UID_FORMAT = /\A[a-zA-Z0-9\-_.]{3,20}\z/
+
+            def self.build(**kwargs)
+              uid = kwargs[:templateContainerUid]
+              raise ArgumentError, 'templateContainerUid is required (String!)' if uid.nil?
+
+              unless UID_FORMAT.match?(uid.to_s)
+                raise ArgumentError,
+                      "Invalid templateContainerUid #{uid.inspect}: " \
+                      'use 3-20 characters (letters, numbers, -, _, . only)'
+              end
+
+              { templateContainerUid: uid.to_s }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/workflow_command/{edit_page_creator_permissions.rb → edit_template_creator_permissions.rb}

@@ -3,8 +3,9 @@ module Ecoportal
     class GraphQL
       module Input
         class WorkflowCommand
-          module EditPageCreatorPermissions
-            SCHEMA_VERSION = '20260605'.freeze
+          # 20260713: replaces the page-level `editPageCreatorPermissions` command (template-scoped).
+          module EditTemplateCreatorPermissions
+            SCHEMA_VERSION = '20260713'.freeze
             VALID_KEYS = %i[creatorEnabled creatorEditable creatorFlags].freeze
 
             def self.build(**kwargs)

data/lib/ecoportal/api/graphql/input/workflow_command/edit_template_descriptions.rb

@@ -0,0 +1,19 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          # 20260713
+          module EditTemplateDescriptions
+            SCHEMA_VERSION = '20260713'.freeze
+            VALID_KEYS = %i[description aiDescription templateType].freeze
+
+            def self.build(**kwargs)
+              kwargs.slice(*VALID_KEYS).compact
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/action_list.rb

@@ -0,0 +1,31 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          module EditFieldConfiguration
+            # `WorkflowEditFieldConfigurationActionListInput` — the 14th (and last unwired)
+            # member of `WorkflowEditFieldConfigurationByTypeInput`. Added to the schema in the
+            # 20260725 drift and never picked up, which left ActionsList the one field type whose
+            # configuration could not be edited through this gem.
+            #
+            # NOTE the naming asymmetry, which is the schema's, not ours: the byType KEY is
+            # `actionList` (singular) while the field TYPE is `ActionsList` (plural) — hence
+            # `Base::Page::DataField::TYPE_MAP` maps `'ActionsList'`. Keep this module named after
+            # the byType key so the registry lookup stays mechanical.
+            module ActionList
+              SCHEMA_VERSION = '20260725'.freeze
+              VALID_KEYS = %i[requiredCompleted].freeze
+              # ActionsListRequiredCompletedEnum (verified against the live schema, 20260731)
+              REQUIRED_COMPLETED = %w[NONE SOME ALL].freeze
+
+              def self.build(**kwargs)
+                { actionList: kwargs.slice(*VALID_KEYS).compact }
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/cross_reference.rb

@@ -5,10 +5,12 @@ module Ecoportal
         class WorkflowCommand
           module EditFieldConfiguration
             module CrossReference
-              SCHEMA_VERSION = '20260605'.freeze
+              SCHEMA_VERSION = '20260713'.freeze
+              # 20260713: gained addReferenceIds/removeReferenceIds (set-diff of attached references).
               VALID_KEYS = %i[
                 displayFields displayFieldsInLookup hideCreate hideAttach hideMetadata
                 registerId attachSourcePage hideDashboards singleSelectMode
+                addReferenceIds removeReferenceIds
               ].freeze
 
               def self.build(**kwargs)

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/date.rb

@@ -5,8 +5,21 @@ module Ecoportal
         class WorkflowCommand
           module EditFieldConfiguration
             module Date
-              SCHEMA_VERSION = '20260605'.freeze
-              VALID_KEYS = %i[showTime pastOnly todayButton smartFillConfiguration removeSmartFillConfiguration].freeze
+              SCHEMA_VERSION = '20260725'.freeze
+              # 20260713: smartFillConfiguration moved out to dedicated add/edit/removeSmartFillConfig commands.
+              # 20260725: gained the date-EVENT and RENEWAL keys below (calendar events + recurring
+              # expiry on a date field). Six keys that had never been reachable from this gem —
+              # renewals are how expiry-driven registers (certifications, inductions, permits)
+              # are configured, so this was a real functional hole, not a cosmetic one.
+              VALID_KEYS = %i[
+                showTime pastOnly todayButton
+                createEvent remindMeIn
+                renews renewsEvery renewsUnit renewsUntil
+              ].freeze
+              # PagesDataFieldsDatesRenewsUnitEnum
+              RENEWS_UNITS = %w[DAY WEEK MONTH YEAR].freeze
+              # DateEventRemindOption
+              REMIND_OPTIONS = %w[NEVER ONE_DAY THREE_DAYS ONE_WEEK TWO_WEEKS ONE_MONTH].freeze
 
               def self.build(**kwargs)
                 { date: kwargs.slice(*VALID_KEYS).compact }

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/file.rb

@@ -0,0 +1,21 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          module EditFieldConfiguration
+            # 20260713: `file` by-type field configuration (set-diff of file containers/items).
+            module File
+              SCHEMA_VERSION = '20260713'.freeze
+              VALID_KEYS = %i[addFileContainerIds removeItemIds].freeze
+
+              def self.build(**kwargs)
+                { file: kwargs.slice(*VALID_KEYS).compact }
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/image_gallery.rb

@@ -5,8 +5,9 @@ module Ecoportal
         class WorkflowCommand
           module EditFieldConfiguration
             module ImageGallery
-              SCHEMA_VERSION = '20260605'.freeze
-              VALID_KEYS = %i[layout stretch noPopup hideOptions].freeze
+              SCHEMA_VERSION = '20260713'.freeze
+              # 20260713: gained addImageSourceIds/removeImageIds (set-diff of gallery images).
+              VALID_KEYS = %i[layout stretch noPopup hideOptions addImageSourceIds removeImageIds].freeze
 
               def self.build(**kwargs)
                 { imageGallery: kwargs.slice(*VALID_KEYS).compact }

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/people.rb

@@ -5,15 +5,39 @@ module Ecoportal
         class WorkflowCommand
           module EditFieldConfiguration
             module People
-              SCHEMA_VERSION = '20260605'.freeze
+              SCHEMA_VERSION = '20260725'.freeze
+              # 20260725: `addViewableFields`/`removeViewableFields` were REMOVED from
+              # WorkflowEditFieldConfigurationPeopleInput — they lived on here as dead keys the
+              # server rejects. Viewable fields are now three dedicated commands
+              # (add/move/removeViewableField), which also added ordering the flat arrays could
+              # not express. The same drift added the six attached-people-permission /
+              # allowed-user-group keys below, which had never been reachable from this gem.
               VALID_KEYS = %i[
                 personSchemaId singular requiresNumber attachMode isMeButton
                 autoSelectMode autoSelectSupervisorFieldRef autoSelectDefaultLocations
-                addViewableFields removeViewableFields
+                addAllowedUserGroupIds removeAllowedUserGroupIds
+                attachedPeoplePermissionsEnabled attachedPeoplePermissionsEditable
+                attachedPeoplePermissionsFlags applyAttachedPeoplePermissionsTo
+              ].freeze
+              # WorkflowAutoSelectModeEnum — `autoSelectMode` was retyped String -> enum in the
+              # same drift. Values pass through as strings (valid for enum variables).
+              AUTO_SELECT_MODES = %w[NONE CREATOR CREATOR_SUPERVISOR PEOPLE_SUPERVISOR].freeze
+              # WorkflowApplyAttachedPeoplePermissionsToEnum
+              APPLY_PERMISSIONS_TO = %w[PAGE_ONLY PAGE ALL_STAGES CURRENT_STAGE].freeze
+              # Nested WorkflowEditFieldConfigurationAttachedPeoplePermissionsFlagsInput keys.
+              PERMISSION_FLAGS = %i[
+                canRestructure canConfigure canPermission canCreateActions
+                canAdministrateActions subscribed subscribedToTasks
               ].freeze
 
               def self.build(**kwargs)
-                { people: kwargs.slice(*VALID_KEYS).compact }
+                out = kwargs.slice(*VALID_KEYS).compact
+                # Filter the nested flags hash to the keys the schema actually declares, so a
+                # stray key can't sink the whole command server-side.
+                if (flags = out[:attachedPeoplePermissionsFlags]).is_a?(Hash)
+                  out[:attachedPeoplePermissionsFlags] = flags.slice(*PERMISSION_FLAGS).compact
+                end
+                { people: out }
               end
             end
           end

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/plain_text.rb

@@ -5,8 +5,9 @@ module Ecoportal
         class WorkflowCommand
           module EditFieldConfiguration
             module PlainText
-              SCHEMA_VERSION = '20260605'.freeze
-              VALID_KEYS = %i[value maxLength embeddingEnabled smartFillConfiguration removeSmartFillConfiguration].freeze
+              SCHEMA_VERSION = '20260713'.freeze
+              # 20260713: smartFillConfiguration moved out to dedicated add/edit/removeSmartFillConfig commands.
+              VALID_KEYS = %i[value maxLength embeddingEnabled].freeze
 
               def self.build(**kwargs)
                 { plainText: kwargs.slice(*VALID_KEYS).compact }

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/rich_text.rb

@@ -5,8 +5,9 @@ module Ecoportal
         class WorkflowCommand
           module EditFieldConfiguration
             module RichText
-              SCHEMA_VERSION = '20260605'.freeze
-              VALID_KEYS = %i[content markdown embeddingEnabled smartFillConfiguration removeSmartFillConfiguration].freeze
+              SCHEMA_VERSION = '20260713'.freeze
+              # 20260713: smartFillConfiguration moved out to dedicated add/edit/removeSmartFillConfig commands.
+              VALID_KEYS = %i[content markdown embeddingEnabled].freeze
 
               def self.build(**kwargs)
                 { richText: kwargs.slice(*VALID_KEYS).compact }

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/select.rb

@@ -5,8 +5,9 @@ module Ecoportal
         class WorkflowCommand
           module EditFieldConfiguration
             module Select
-              SCHEMA_VERSION = '20260605'.freeze
-              VALID_KEYS = %i[dataType multiple flat other otherDesc smartFillConfiguration removeSmartFillConfiguration].freeze
+              SCHEMA_VERSION = '20260713'.freeze
+              # 20260713: smartFillConfiguration moved out to dedicated add/edit/removeSmartFillConfig commands.
+              VALID_KEYS = %i[dataType multiple flat other otherDesc].freeze
 
               def self.build(**kwargs)
                 { select: kwargs.slice(*VALID_KEYS).compact }

data/lib/ecoportal/api/graphql/input/workflow_command/move_field.rb

@@ -4,8 +4,9 @@ module Ecoportal
       module Input
         class WorkflowCommand
           module MoveField
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[id sectionId column].freeze
+            SCHEMA_VERSION = '20260713'.freeze
+            # 20260713: gained anchor-based positioning (anchorId/anchorPosition).
+            VALID_KEYS = %i[id sectionId column anchorId anchorPosition].freeze
 
             def self.build(**kwargs)
               kwargs.slice(*VALID_KEYS).compact

data/lib/ecoportal/api/graphql/input/workflow_command/move_viewable_field.rb

@@ -0,0 +1,33 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          # `WorkflowMoveViewableFieldInput` — reorders a viewable field on a People data field.
+          # Same shape as AddViewableField minus `schemaFieldType` (the field already exists, so
+          # its type is known server-side). See AddViewableField for why these three commands
+          # replaced the removed `people.add/removeViewableFields` arrays.
+          module MoveViewableField
+            SCHEMA_VERSION = '20260725'.freeze
+            VALID_KEYS = %i[dataFieldId schemaFieldId anchorId anchorPosition].freeze
+            ANCHOR_POSITIONS = AddViewableField::ANCHOR_POSITIONS
+
+            def self.build(data_field_id:, schema_field_id:, **kwargs)
+              position = kwargs[:anchorPosition]
+              unless position.nil? || ANCHOR_POSITIONS.include?(position.to_s)
+                raise ArgumentError,
+                      "Invalid anchorPosition #{position.inspect}: " \
+                      "expected one of #{ANCHOR_POSITIONS.join(', ')}"
+              end
+
+              {
+                dataFieldId:   data_field_id,
+                schemaFieldId: schema_field_id
+              }.merge(kwargs.slice(:anchorId, :anchorPosition).compact)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/workflow_command/remove_checklist_field_item.rb

@@ -0,0 +1,19 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          # 20260713
+          module RemoveChecklistFieldItem
+            SCHEMA_VERSION = '20260713'.freeze
+            VALID_KEYS = %i[dataFieldId itemId].freeze
+
+            def self.build(**kwargs)
+              kwargs.slice(*VALID_KEYS).compact
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/workflow_command/remove_smart_fill_config.rb

@@ -0,0 +1,19 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          # 20260713
+          module RemoveSmartFillConfig
+            SCHEMA_VERSION = '20260713'.freeze
+            VALID_KEYS = %i[dataFieldId].freeze
+
+            def self.build(**kwargs)
+              kwargs.slice(*VALID_KEYS).compact
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/workflow_command/remove_viewable_field.rb

@@ -0,0 +1,21 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          # `WorkflowRemoveViewableFieldInput` — removes a viewable field from a People data
+          # field. Both keys are required (`ID!`). Replaces the removed
+          # `people.removeViewableFields` array — see AddViewableField.
+          module RemoveViewableField
+            SCHEMA_VERSION = '20260725'.freeze
+            VALID_KEYS = %i[dataFieldId schemaFieldId].freeze
+
+            def self.build(data_field_id:, schema_field_id:)
+              { dataFieldId: data_field_id, schemaFieldId: schema_field_id }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/workflow_command/reorder_forces.rb

@@ -4,8 +4,9 @@ module Ecoportal
       module Input
         class WorkflowCommand
           module ReorderForces
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[forceId after before].freeze
+            SCHEMA_VERSION = '20260713'.freeze
+            # 20260713: `after`/`before` replaced by anchor-based positioning.
+            VALID_KEYS = %i[forceId anchorId anchorPosition].freeze
 
             def self.build(**kwargs)
               kwargs.slice(*VALID_KEYS).compact

data/lib/ecoportal/api/graphql/input/workflow_command/reorder_section.rb

@@ -4,8 +4,9 @@ module Ecoportal
       module Input
         class WorkflowCommand
           module ReorderSection
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[sectionId stageId after before].freeze
+            SCHEMA_VERSION = '20260713'.freeze
+            # 20260713: `after`/`before` replaced by anchor-based positioning.
+            VALID_KEYS = %i[sectionId stageId anchorId anchorPosition].freeze
 
             def self.build(**kwargs)
               kwargs.slice(*VALID_KEYS).compact

data/lib/ecoportal/api/graphql/input/workflow_command.rb

@@ -6,9 +6,17 @@ module Ecoportal
           SCHEMA_VERSION = '20260605'.freeze
 
           COMMAND_MAP = {
-            # Page-level
-            editPage:                          'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditPage',
-            editPageCreatorPermissions:        'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditPageCreatorPermissions',
+            # Template settings (20260713 — supersede the removed page-level editPage/editPageCreatorPermissions)
+            editTemplateBasicSettings:         'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditTemplateBasicSettings',
+            editTemplateAdvancedSettings:      'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditTemplateAdvancedSettings',
+            editTemplateCreatorPermissions:    'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditTemplateCreatorPermissions',
+            editTemplateDescriptions:          'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditTemplateDescriptions',
+            # Cross-version template identity (the series key) — see the input class for the
+            # publish-swap rule that makes it usable as an entity id across versions.
+            editTemplateContainerUid:          'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditTemplateContainerUid',
+            createPublicConfig:                'Ecoportal::API::GraphQL::Input::WorkflowCommand::CreatePublicConfig',
+            editPublicConfig:                  'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditPublicConfig',
+            archivePublicConfig:               'Ecoportal::API::GraphQL::Input::WorkflowCommand::ArchivePublicConfig',
             # Stage structural
             addStage:                          'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddStage',
             removeStage:                       'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveStage',
@@ -91,6 +99,19 @@ module Ecoportal
             removeField:                       'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveField',
             # Field config
             editFieldConfiguration:            'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditFieldConfiguration',
+            # Viewable fields on People data fields (20260725) — replaced the REMOVED
+            # `people.addViewableFields`/`removeViewableFields` arrays; see AddViewableField.
+            addViewableField:                  'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddViewableField',
+            moveViewableField:                 'Ecoportal::API::GraphQL::Input::WorkflowCommand::MoveViewableField',
+            removeViewableField:               'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveViewableField',
+            # Checklist field items (20260713)
+            addChecklistFieldItem:             'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddChecklistFieldItem',
+            editChecklistFieldItem:            'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditChecklistFieldItem',
+            removeChecklistFieldItem:          'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveChecklistFieldItem',
+            # Smart-fill config (20260713 — extracted from field-config inputs)
+            addSmartFillConfig:                'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddSmartFillConfig',
+            editSmartFillConfig:               'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditSmartFillConfig',
+            removeSmartFillConfig:             'Ecoportal::API::GraphQL::Input::WorkflowCommand::RemoveSmartFillConfig',
             # Select options
             addSelectFieldOption:              'Ecoportal::API::GraphQL::Input::WorkflowCommand::AddSelectFieldOption',
             editSelectFieldOption:             'Ecoportal::API::GraphQL::Input::WorkflowCommand::EditSelectFieldOption',
@@ -147,8 +168,20 @@ module Ecoportal
   end
 end
 
-require_relative 'workflow_command/edit_page'
-require_relative 'workflow_command/edit_page_creator_permissions'
+require_relative 'workflow_command/edit_template_basic_settings'
+require_relative 'workflow_command/edit_template_advanced_settings'
+require_relative 'workflow_command/edit_template_creator_permissions'
+require_relative 'workflow_command/edit_template_descriptions'
+require_relative 'workflow_command/edit_template_container_uid'
+require_relative 'workflow_command/create_public_config'
+require_relative 'workflow_command/edit_public_config'
+require_relative 'workflow_command/archive_public_config'
+require_relative 'workflow_command/add_checklist_field_item'
+require_relative 'workflow_command/edit_checklist_field_item'
+require_relative 'workflow_command/remove_checklist_field_item'
+require_relative 'workflow_command/add_smart_fill_config'
+require_relative 'workflow_command/edit_smart_fill_config'
+require_relative 'workflow_command/remove_smart_fill_config'
 require_relative 'workflow_command/add_stage'
 require_relative 'workflow_command/remove_stage'
 require_relative 'workflow_command/edit_stage'
@@ -237,9 +270,14 @@ require_relative 'workflow_command/remove_binding'
 require_relative 'workflow_command/add_linked_helper'
 require_relative 'workflow_command/edit_linked_helper'
 require_relative 'workflow_command/remove_linked_helper'
+require_relative 'workflow_command/add_viewable_field'
+require_relative 'workflow_command/move_viewable_field'
+require_relative 'workflow_command/remove_viewable_field'
+require_relative 'workflow_command/field_config/action_list'
 require_relative 'workflow_command/field_config/contractor_entities'
 require_relative 'workflow_command/field_config/cross_reference'
 require_relative 'workflow_command/field_config/date'
+require_relative 'workflow_command/field_config/file'
 require_relative 'workflow_command/field_config/gauge'
 require_relative 'workflow_command/field_config/image_gallery'
 require_relative 'workflow_command/field_config/location_field'

data/lib/ecoportal/api/graphql/input.rb

@@ -16,6 +16,7 @@ require_relative 'input/contractor_entity'
 require_relative 'input/action'
 require_relative 'input/page'
 require_relative 'input/delta_input'
+require_relative 'input/date_range'
 require_relative 'input/search_conf'
 
 require_relative 'input/register'

data/lib/ecoportal/api/graphql/interface/base_page.rb

@@ -6,6 +6,12 @@ module Ecoportal
           include Concerns::PageCompat
           include Concerns::DataFieldAccess
 
+          # Page-level leaf arrays (`otherTags`, whole-set `locations`) are cascaded
+          # attributes the default DiffService cannot see. LeafDiffService diffs them
+          # inline (full-set replace) while still cascading into real nested models
+          # (e.g. a phased page's `stages`). See Diffable::LeafDiffService.
+          DIFF_CLASS = Ecoportal::API::Common::GraphQL::Model::Diffable::LeafDiffService
+
           passkey :id
           passthrough :name, :uid
           passthrough :icon
@@ -15,7 +21,6 @@ module Ecoportal
           # class_resolver :force_class, 'Ecoportal::API::GraphQL::Base::Force'
           # class_resolver :task_class, 'Ecoportal::API::GraphQL::Interface::Task'
           # class_resolver :theme_class, 'Ecoportal::API::GraphQL::Base::Theme'
-          # class_resolver :template_class, 'Ecoportal::API::GraphQL::Base::Template'
           # class_resolver :register_class, 'Ecoportal::API::GraphQL::Base::Register'
           class_resolver :organization_class, 'Ecoportal::API::GraphQL::Base::Organization'
 
@@ -41,7 +46,6 @@ module Ecoportal
           # embeds_one :taskPriority, klass: 'BasePage::TaskPriorityEnum', read_only: true
           passthrough :taskPriority
 
-
           passthrough :patchVer
 
           passboolean :draft, :archived
@@ -78,7 +82,36 @@ module Ecoportal
           # the CreateFromTemplateInput preview. nil for fetched/persisted pages.
           attr_accessor :_compat_source_template_id
 
-          # embeds_one :template, klass: :template_class, read_only: true
+          # The narrow `Template` type (NOT the template page — see Base::Template for the
+          # asymmetry). Populated only for template pages; nil for records. Carries
+          # `templateContainerUid`, the cross-version series key.
+          class_resolver :template_class, 'Ecoportal::API::GraphQL::Model::Template::Information'
+
+          # Deliberately NOT `embeds_one ..., read_only: true`, and this is not a style choice:
+          # `read_only` does not keep a mutated child out of the parent's diff. With `embeds_one`,
+          # `page.template.templateContainerUid = 'x'` yields
+          # `as_update => { id:, template: { templateContainerUid: 'x' } }` — but `UpdatePageInput`
+          # has NO `template` member, so that would push a key `updatePage` cannot accept. The
+          # only writer for the series key is the `editTemplateContainerUid` workflow command.
+          #
+          # So this follows the same on-demand read-only pattern as `#forces` above, over a COPY of
+          # the sub-doc: the returned model is a genuine dead end — writes to it cannot reach
+          # `doc`, cannot dirty the page, and cannot leak into an update.
+          def template
+            return nil unless (raw = doc['template'])
+
+            @template ||= template_class.new(
+              Ecoportal::API::Common::GraphQL::HashHelpers.deep_dup(raw)
+            )
+          end
+
+          # Convenience reader for the cross-version series key — nil unless this page is a
+          # template AND the read selected `template { templateContainerUid }` (CommonPageUnion
+          # does). Many versions may share one uid; only one may be published at a time.
+          def templateContainerUid
+            template&.templateContainerUid
+          end
+
           # embeds_many :registers, klass: :register_class, read_only: true
           # embeds_one :organization, klass: :organization_class, read_only: true
 

data/lib/ecoportal/api/graphql/interface/location_structure/command.rb

@@ -17,7 +17,8 @@ module Ecoportal
 
             def set_values(**kargs)
               kargs.each do |key, value|
-                send(key, value) if respond_to?(key, true)
+                writer = "#{key}="
+                send(writer, value) if respond_to?(writer, true)
               end
 
               self

data/lib/ecoportal/api/graphql/logic/connection.rb

@@ -18,6 +18,23 @@ module Ecoportal
           embeds_many :nodes, klass: :node_class
           embeds_one :pageInfo, klass: Base::PageInfo
 
+          # Bind a connection subclass to its concrete node type.
+          #
+          # The base `embeds_many :nodes, klass: :node_class` builds a SINGLE dynamic
+          # `CollectionModel` ("nodes::node_class") that every subclass inherits and shares.
+          # The v2 collection layer memoizes the resolved class on that shared collection
+          # (items_klass.rb:62-63), so the FIRST connection instantiated in a process poisons
+          # every other connection's instance `nodes` typing (e.g. a MinimalDashboard connection
+          # returning AuthLog nodes). Declaring `embeds_many :nodes` per subclass with the concrete
+          # class gives each subclass its OWN collection ("nodes::Model::X") bound to a real Class —
+          # no shared symbol, nothing to memoize wrongly.
+          #
+          # Use `nodes_of Model::X` in a subclass instead of `class_resolver :node_class, Model::X`.
+          def self.nodes_of(klass)
+            class_resolver :node_class, klass
+            embeds_many :nodes, klass: klass
+          end
+
           def empty?
             count < 1
           end