ecoportal-api-graphql 2.0.0 → 3.0.0

data/lib/ecoportal/api/graphql/query/register_preview_pages.rb

@@ -1,83 +1,83 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Query
-        # Elasticsearch-backed fast search within a register.
-        # Returns PreviewPage nodes — no field IDs, no patchVer.
-        # Use for metadata lookup (find by externalId, state, location, date).
-        # Switch to Query::Pages (org search) for full data before mutations.
-        #
-        # Supports includeArchived: Boolean (default false).
-        # Supports presetViewId: ID to apply a register PageView preset.
-        class RegisterPreviewPages < Logic::QueryConnection
-          field_name :previewPages
-
-          accepted_params :registerId, :after, :before, :first, :last,
-                          :searchConf, :includeArchived, :presetViewId
-
-          class_resolver :item_class,       'Ecoportal::API::GraphQL::Model::PreviewPage'
-          class_resolver :connection_class, 'Ecoportal::API::GraphQL::Connection::PreviewPage'
-
-          def path
-            %w[currentOrganization register previewPages]
-          end
-
-          private
-
-          def basic_block(&block)
-            connection_block = block || default_connection_block
-            proc {
-              query(
-                registerId:      :id!,
-                after:           :string,
-                before:          :string,
-                first:           :int,
-                last:            :int,
-                searchConf:      :Search,
-                includeArchived: :boolean,
-                presetViewId:    :id
-              ) {
-                currentOrganization {
-                  register(id: :registerId) {
-                    previewPages(
-                      after:           :after,
-                      before:          :before,
-                      first:           :first,
-                      last:            :last,
-                      searchConf:      :searchConf,
-                      includeArchived: :includeArchived,
-                      presetViewId:    :presetViewId,
-                      &connection_block
-                    )
-                  }
-                }
-              }
-            }
-          end
-
-          def default_connection_block
-            proc {
-              totalCount
-              pageInfo {
-                endCursor
-                hasNextPage
-              }
-              nodes {
-                id
-                uid
-                name
-                state
-                archived
-                externalId
-                creatorName
-                createdAt { dateTime timeZone }
-                updatedAt { dateTime timeZone }
-                locations { id name }
-              }
-            }
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        # Elasticsearch-backed fast search within a register.
+        # Returns PreviewPage nodes — no field IDs, no patchVer.
+        # Use for metadata lookup (find by externalId, state, location, date).
+        # Switch to Query::Pages (org search) for full data before mutations.
+        #
+        # Supports includeArchived: Boolean (default false).
+        # Supports presetViewId: ID to apply a register PageView preset.
+        class RegisterPreviewPages < Logic::QueryConnection
+          field_name :previewPages
+
+          accepted_params :registerId, :after, :before, :first, :last,
+                          :searchConf, :includeArchived, :presetViewId
+
+          class_resolver :item_class,       'Ecoportal::API::GraphQL::Model::PreviewPage'
+          class_resolver :connection_class, 'Ecoportal::API::GraphQL::Connection::PreviewPage'
+
+          def path
+            %w[currentOrganization register previewPages]
+          end
+
+          private
+
+          def basic_block(&block)
+            connection_block = block || default_connection_block
+            proc {
+              query(
+                registerId:      :id!,
+                after:           :string,
+                before:          :string,
+                first:           :int,
+                last:            :int,
+                searchConf:      :Search,
+                includeArchived: :boolean,
+                presetViewId:    :id
+              ) {
+                currentOrganization {
+                  register(id: :registerId) {
+                    previewPages(
+                      after:           :after,
+                      before:          :before,
+                      first:           :first,
+                      last:            :last,
+                      searchConf:      :searchConf,
+                      includeArchived: :includeArchived,
+                      presetViewId:    :presetViewId,
+                      &connection_block
+                    )
+                  }
+                }
+              }
+            }
+          end
+
+          def default_connection_block
+            proc {
+              totalCount
+              pageInfo {
+                endCursor
+                hasNextPage
+              }
+              nodes {
+                id
+                uid
+                name
+                state
+                archived
+                externalId
+                creatorName
+                createdAt { dateTime timeZone }
+                updatedAt { dateTime timeZone }
+                locations { id name }
+              }
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/query/template_change_log.rb

@@ -0,0 +1,118 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        # TEMPLATE CHANGE LOG — "for template X, who changed what, and when", newest first,
+        # paginated.
+        #
+        # Read path (verified in the Rails backend on 2026-08-19):
+        #   currentOrganization.page(id:) → template → commands
+        # There is NO top-level query for the narrow `Template` type. `template` is declared on
+        # `app/graphql/types/pages/interfaces/base_page_interface.rb:27`, so it is reachable on
+        # any page — and a template IS a page in this platform, so pass the TEMPLATE's page id.
+        #
+        # `currentOrganization.page(id:)` returns a `PageUnion`, so `template` has to be selected
+        # through a type condition on `BasePageInterface` — selecting directly on a union is
+        # invalid GraphQL under any schema (this is the class of bug the `validate-queries` CI
+        # gate hard-fails on). The type condition does not change the response shape, so `#path`
+        # still digs currentOrganization → page → template → commands.
+        #
+        # ★ Access caveats and the forces watermark blind spot are documented on
+        # `Base::Template::ChangeLogEntry`. In short: a nil `commands` connection means the caller
+        # lacks `Pages::TemplatePolicy#update_information?`, NOT that nothing changed; and only
+        # TEMPLATE_BUILDER-sourced commands appear here (workflow-builder ones live on
+        # `Query::PagesWorkflowCommands`).
+        #
+        # Usage:
+        #   q = Query::TemplateChangeLog.new(client)
+        #   conn = q.query(id: template_page_id, first: 50)
+        #   conn.nodes.each { |e| puts "#{e.createdAt.dateTime} #{e.owner&.name} #{e.commandAction}" }
+        #
+        #   # auto-paginating enumerator (Logic::QueryConnection#each)
+        #   q.each(id: template_page_id, first: 100) { |entry| ... }
+        #
+        # Also reachable as `api.template.change_log(id:, first:)` — see `Builder::Template`.
+        #
+        # ★ For WHAT CHANGED (field/from/to, change messages) pass `detail: true` to the builder,
+        # or `&Query::TemplateChangeLog.detail_block` here. The default selection deliberately
+        # omits it so the common "who and when" read stays cheap.
+        class TemplateChangeLog < Logic::QueryConnection
+          SCHEMA_VERSION = '20260819'.freeze
+
+          field_name :commands
+
+          accepted_params :id, :after, :before, :first, :last
+
+          class_resolver :item_class,       'Ecoportal::API::GraphQL::Model::Template::ChangeLogEntry'
+          class_resolver :connection_class, 'Ecoportal::API::GraphQL::Connection::TemplateChangeLog'
+
+          # Absolute — the connection is nested three levels deep, so it is not expressible as
+          # `base_path + field_name`.
+          def path
+            %w[currentOrganization page template commands]
+          end
+
+          # Connection block that selects FIELD-LEVEL DETAIL as well -- what changed, not just
+          # who/when/which-resource. Opt-in, because it adds three inline fragments and their
+          # sub-selections to every node.
+          #
+          #   q = Query::TemplateChangeLog.new(client)
+          #   conn = q.query(id: template_page_id, first: 50, &described_class.detail_block)
+          #   conn.nodes.each do |e|
+          #     case e.detail_kind
+          #     when :changes         then e.changes.each { |c| puts "#{c['field']}: #{c['from']} -> #{c['to']}" }
+          #     when :change_messages then puts e.changeMessages.join('; ')
+          #     when :es_changes      then puts "filter changed: #{e.changes.map { |c| c['field'] }.join(', ')}"
+          #     end
+          #   end
+          #
+          # Or simply `api.template.change_log(id:, first:, detail: true)`.
+          def self.detail_block
+            proc {
+              totalCount
+              pageInfo {
+                endCursor
+                hasNextPage
+              }
+              nodes {
+                spread :TemplateChangeLogEntryDetail
+              }
+            }
+          end
+
+          private
+
+          def basic_block(&block)
+            connection_block = block || default_connection_block
+            proc {
+              query(id: :id!, after: :string, before: :string, first: :int, last: :int) {
+                currentOrganization {
+                  page(id: :id) {
+                    spread on: :BasePageInterface do
+                      template {
+                        commands(after: :after, before: :before, first: :first, last: :last, &connection_block)
+                      }
+                    end
+                  }
+                }
+              }
+            }
+          end
+
+          def default_connection_block
+            proc {
+              totalCount
+              pageInfo {
+                endCursor
+                hasNextPage
+              }
+              nodes {
+                spread :TemplateChangeLogEntry
+              }
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/query/templates.rb

@@ -1,53 +1,53 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Query
-        class Templates < Logic::QueryConnection
-          field_name :templates
-
-          class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
-          class_resolver :connection_class, 'Ecoportal::API::GraphQL::Connection::Page'
-
-          private
-
-          def basic_block(&block)
-            connection_block = block || default_connection_block
-            proc {
-              query(
-                searchConf: :Search,
-                after:      :string,
-                before:     :string,
-                first:      :int,
-                last:       :int
-              ) {
-                currentOrganization {
-                  templates(
-                    searchConf: :searchConf,
-                    after:      :after,
-                    before:     :before,
-                    first:      :first,
-                    last:       :last,
-                    &connection_block
-                  )
-                }
-              }
-            }
-          end
-
-          def default_connection_block
-            proc {
-              totalCount
-              pageInfo {
-                endCursor
-                hasNextPage
-              }
-              nodes {
-                spread :PageFields
-              }
-            }
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        class Templates < Logic::QueryConnection
+          field_name :templates
+
+          class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+          class_resolver :connection_class, 'Ecoportal::API::GraphQL::Connection::Page'
+
+          private
+
+          def basic_block(&block)
+            connection_block = block || default_connection_block
+            proc {
+              query(
+                searchConf: :Search,
+                after:      :string,
+                before:     :string,
+                first:      :int,
+                last:       :int
+              ) {
+                currentOrganization {
+                  templates(
+                    searchConf: :searchConf,
+                    after:      :after,
+                    before:     :before,
+                    first:      :first,
+                    last:       :last,
+                    &connection_block
+                  )
+                }
+              }
+            }
+          end
+
+          def default_connection_block
+            proc {
+              totalCount
+              pageInfo {
+                endCursor
+                hasNextPage
+              }
+              nodes {
+                spread :PageFields
+              }
+            }
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -19,6 +19,7 @@ require_relative 'query/page_activities'
 require_relative 'query/auth_logs'
 require_relative 'query/permissions'
 require_relative 'query/person_member_changelogs'
+require_relative 'query/person_members'
 require_relative 'query/dashboard_search'
 require_relative 'query/page'
 require_relative 'query/pages'
@@ -31,3 +32,4 @@ require_relative 'query/file_upload_signature'
 
 require_relative 'query/page_with_forces'
 require_relative 'query/pages_workflow_commands'
+require_relative 'query/template_change_log'

data/lib/ecoportal/api/graphql_version.rb

@@ -1,5 +1,5 @@
 module Ecoportal
   module API
-    GRAPQL_VERSION = '2.0.0'.freeze
+    GRAPQL_VERSION = '3.0.0'.freeze
   end
 end

data/lib/ecoportal/api-graphql.rb

@@ -1,10 +1,10 @@
-require "ecoportal/api-v2"
-require "ecoportal/api/graphql_version"
-
-module Ecoportal
-  module API
-  end
-end
-
-require_relative "api/common.graphql"
-require_relative "api/graphql"
+require "ecoportal/api-v2"
+require "ecoportal/api/graphql_version"
+
+module Ecoportal
+  module API
+  end
+end
+
+require_relative "api/common.graphql"
+require_relative "api/graphql"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ecoportal-api-graphql
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Oscar Segura
@@ -9,6 +9,20 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: json-canonicalization
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -160,7 +174,7 @@ dependencies:
         version: '3.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.3.3
+        version: 3.3.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -170,7 +184,7 @@ dependencies:
         version: '3.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.3.3
+        version: 3.3.5
 - !ruby/object:Gem::Dependency
   name: graphlient
   requirement: !ruby/object:Gem::Requirement
@@ -199,18 +213,16 @@ extra_rdoc_files: []
 files:
 - CHANGELOG.md
 - LICENSE
-- README.md
+- README.gem.md
 - lib/ecoportal/api-graphql.rb
 - lib/ecoportal/api/common.graphql.rb
 - lib/ecoportal/api/common/graphql.rb
-- lib/ecoportal/api/common/graphql/CLAUDE.md
 - lib/ecoportal/api/common/graphql/auth_service.rb
 - lib/ecoportal/api/common/graphql/class_helpers.rb
 - lib/ecoportal/api/common/graphql/client.rb
 - lib/ecoportal/api/common/graphql/hash_helpers.rb
 - lib/ecoportal/api/common/graphql/http_client.rb
 - lib/ecoportal/api/common/graphql/model.rb
-- lib/ecoportal/api/common/graphql/model/CLAUDE.md
 - lib/ecoportal/api/common/graphql/model/as_input.rb
 - lib/ecoportal/api/common/graphql/model/diffable.rb
 - lib/ecoportal/api/common/graphql/model/diffable/classic_diff_service.rb
@@ -221,9 +233,7 @@ files:
 - lib/ecoportal/api/common/graphql/patches.rb
 - lib/ecoportal/api/common/graphql/query_integration.rb
 - lib/ecoportal/api/graphql.rb
-- lib/ecoportal/api/graphql/CLAUDE.md
 - lib/ecoportal/api/graphql/base.rb
-- lib/ecoportal/api/graphql/base/CLAUDE.md
 - lib/ecoportal/api/graphql/base/action.rb
 - lib/ecoportal/api/graphql/base/action_category.rb
 - lib/ecoportal/api/graphql/base/action_event.rb
@@ -315,9 +325,10 @@ files:
 - lib/ecoportal/api/graphql/base/preview_page.rb
 - lib/ecoportal/api/graphql/base/register.rb
 - lib/ecoportal/api/graphql/base/resource.rb
+- lib/ecoportal/api/graphql/base/temp_image.rb
 - lib/ecoportal/api/graphql/base/template.rb
+- lib/ecoportal/api/graphql/base/template/change_log_entry.rb
 - lib/ecoportal/api/graphql/builder.rb
-- lib/ecoportal/api/graphql/builder/CLAUDE.md
 - lib/ecoportal/api/graphql/builder/action.rb
 - lib/ecoportal/api/graphql/builder/contractor_entity.rb
 - lib/ecoportal/api/graphql/builder/kickstand.rb
@@ -358,6 +369,7 @@ files:
 - lib/ecoportal/api/graphql/connection/person_member_changelog.rb
 - lib/ecoportal/api/graphql/connection/preset_view.rb
 - lib/ecoportal/api/graphql/connection/preview_page.rb
+- lib/ecoportal/api/graphql/connection/template_change_log.rb
 - lib/ecoportal/api/graphql/diff.rb
 - lib/ecoportal/api/graphql/diff/change.rb
 - lib/ecoportal/api/graphql/diff/command_synthesizer.rb
@@ -400,6 +412,7 @@ files:
 - lib/ecoportal/api/graphql/fragment/permissions.rb
 - lib/ecoportal/api/graphql/fragment/person_member_changelog.rb
 - lib/ecoportal/api/graphql/fragment/template.rb
+- lib/ecoportal/api/graphql/fragment/template_change_log.rb
 - lib/ecoportal/api/graphql/helpers.rb
 - lib/ecoportal/api/graphql/helpers/locations_tree.rb
 - lib/ecoportal/api/graphql/input.rb
@@ -534,7 +547,9 @@ files:
 - lib/ecoportal/api/graphql/input/workflow_command/field_config/select.rb
 - lib/ecoportal/api/graphql/input/workflow_command/field_config/signature.rb
 - lib/ecoportal/api/graphql/input/workflow_command/field_config/table.rb
+- lib/ecoportal/api/graphql/input/workflow_command/manage_copy_page_configuration.rb
 - lib/ecoportal/api/graphql/input/workflow_command/move_field.rb
+- lib/ecoportal/api/graphql/input/workflow_command/move_section_to_stage.rb
 - lib/ecoportal/api/graphql/input/workflow_command/move_stage.rb
 - lib/ecoportal/api/graphql/input/workflow_command/move_viewable_field.rb
 - lib/ecoportal/api/graphql/input/workflow_command/remove_action_tag.rb
@@ -625,7 +640,23 @@ files:
 - lib/ecoportal/api/graphql/model/preview_page.rb
 - lib/ecoportal/api/graphql/model/register.rb
 - lib/ecoportal/api/graphql/model/resource.rb
+- lib/ecoportal/api/graphql/model/temp_image.rb
 - lib/ecoportal/api/graphql/model/template.rb
+- lib/ecoportal/api/graphql/model/template/binding.rb
+- lib/ecoportal/api/graphql/model/template/change_log_entry.rb
+- lib/ecoportal/api/graphql/model/template/command_grouper.rb
+- lib/ecoportal/api/graphql/model/template/command_normalizer.rb
+- lib/ecoportal/api/graphql/model/template/command_synthesis.rb
+- lib/ecoportal/api/graphql/model/template/field.rb
+- lib/ecoportal/api/graphql/model/template/force.rb
+- lib/ecoportal/api/graphql/model/template/helper.rb
+- lib/ecoportal/api/graphql/model/template/instance.rb
+- lib/ecoportal/api/graphql/model/template/node.rb
+- lib/ecoportal/api/graphql/model/template/option.rb
+- lib/ecoportal/api/graphql/model/template/read.rb
+- lib/ecoportal/api/graphql/model/template/section.rb
+- lib/ecoportal/api/graphql/model/template/stage.rb
+- lib/ecoportal/api/graphql/model/template/staged_executor.rb
 - lib/ecoportal/api/graphql/model/user.rb
 - lib/ecoportal/api/graphql/mutation.rb
 - lib/ecoportal/api/graphql/mutation/action.rb
@@ -642,6 +673,8 @@ files:
 - lib/ecoportal/api/graphql/mutation/contractor_entity/update_manager_settings.rb
 - lib/ecoportal/api/graphql/mutation/file_container.rb
 - lib/ecoportal/api/graphql/mutation/file_container/upload.rb
+- lib/ecoportal/api/graphql/mutation/image.rb
+- lib/ecoportal/api/graphql/mutation/image/upload.rb
 - lib/ecoportal/api/graphql/mutation/kickstand.rb
 - lib/ecoportal/api/graphql/mutation/kickstand/bulk_update_jobs.rb
 - lib/ecoportal/api/graphql/mutation/kickstand/bulk_update_workflows.rb
@@ -706,6 +739,7 @@ files:
 - lib/ecoportal/api/graphql/payload/contractor_entity/update.rb
 - lib/ecoportal/api/graphql/payload/execute_workflow_commands.rb
 - lib/ecoportal/api/graphql/payload/force_commands.rb
+- lib/ecoportal/api/graphql/payload/images_upload.rb
 - lib/ecoportal/api/graphql/payload/kickstand.rb
 - lib/ecoportal/api/graphql/payload/kickstand/bulk_update_jobs.rb
 - lib/ecoportal/api/graphql/payload/kickstand/bulk_update_workflows.rb
@@ -764,8 +798,10 @@ files:
 - lib/ecoportal/api/graphql/query/pages_workflow_commands.rb
 - lib/ecoportal/api/graphql/query/permissions.rb
 - lib/ecoportal/api/graphql/query/person_member_changelogs.rb
+- lib/ecoportal/api/graphql/query/person_members.rb
 - lib/ecoportal/api/graphql/query/register_preset_views.rb
 - lib/ecoportal/api/graphql/query/register_preview_pages.rb
+- lib/ecoportal/api/graphql/query/template_change_log.rb
 - lib/ecoportal/api/graphql/query/templates.rb
 - lib/ecoportal/api/graphql_version.rb
 homepage: https://www.ecoportal.com

data/README.md

@@ -1,24 +0,0 @@
-# Ecoportal::API::GraphQL
-
-This is a basic collection of helpers that can be used to interact with the
-[ecoPortal](https://www.ecoportal.com) `GraphQL` API
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'ecoportal-api-graphql', require: %w[ecoportal/api-graphql]
-```
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install ecoportal-api-graphql
-
-## Changelog
-
-See {file:CHANGELOG.md} for a list of changes.

data/lib/ecoportal/api/common/graphql/CLAUDE.md

@@ -1,36 +0,0 @@
-# common/graphql
-
-Shared HTTP transport, authentication, and base model infrastructure used by the gem — nothing here is EcoPortal-domain-specific.
-
-## Contents
-
-| File / class | Purpose |
-|---|---|
-| `auth_service.rb` / `AuthService` | OAuth2 password + refresh-token flow; included in both client classes |
-| `client.rb` / `Client` | Graphlient-based GraphQL client (builds bearer-token headers, constructs endpoint URL) |
-| `http_client.rb` / `HttpClient` | Raw HTTP client (extends `Common::Client`); `execute` sends query strings + variables; supports v0–v3 + graphql API version modes |
-| `class_helpers.rb` / `ClassHelpers` | `becomes(klass)` instance casting + `const?` class helper |
-| `hash_helpers.rb` / `HashHelpers` | Deep key transforms (`keys_to_sym_deep`, `deep_dup`, `remove_nil_keys_deep`) — used by diff and input serialisation |
-| `query_integration.rb` / `QueryIntegration` | Class macro `query(:method, query_klass:)` that wires a named query method on `Model::Organization` |
-| `model.rb` / `Model` | Base model class: `DoubleModel` + `Diffable` + `AsInput`; all GraphQL models ultimately inherit this |
-| `patches.rb` | Reserved placeholder (empty) |
-| `model/diffable.rb` | `as_update` / `dirty?` — delegates to `DiffService` |
-| `model/as_input.rb` | `as_input` (instance) and `as_input(hash)` (class method) — converts diff to GraphQL mutation variables |
-| `model/diffable/diff_service.rb` | Main diff engine: flat classic diff + cascaded reduce through nested `GraphQL::Model` objects |
-| `model/diffable/classic_diff_service.rb` | Low-level change-data extraction (compares `curr_doc` vs `prev_doc`) |
-| `model/diffable/hash_diff.rb` | Hash equality / change detection helpers |
-| `model/diffable/hash_diff_nesting.rb` | Nested key path helpers (`dig_set!`, `dig_delete!`, `dig_path?`) |
-
-## Conventions
-
-- `Client` is graphlient-based and used for schema introspection; `HttpClient` is the actual request sender used in production (set as `client.http_client`).
-- `HashHelpers` is used as both a module mixin (include) and directly via `HashHelpers.keys_to_sym_deep(...)`.
-- `DiffService` handles the `flat:` flag: `flat: true` does a single-level diff; `flat: false` (default) cascades through nested `GraphQL::Model` objects.
-- Root-class objects (`root!` declared) are excluded from cascaded diffs — they represent independent server entities.
-- `AsInput#as_input(target_class:)` delegates to `Input::X.from_model(self)` when a target class is given.
-
-## Related
-
-- `../graphql/logic/base_model.rb` — adds `SnakeCamelAccess` on top of `Common::GraphQL::Model`
-- `../graphql/logic/input.rb` — `Logic::Input` base class built on top of `Model`
-- `../graphql/logic/base_query.rb` — consumes `HttpClient#execute` and `HashHelpers`