ecoportal-api-graphql 2.0.0 → 3.0.0

data/lib/ecoportal/api/graphql/fragment/locations_error.rb

@@ -1,19 +1,19 @@
-module Ecoportal
-  module API
-    class GraphQL
-      class Fragment
-        fragment :LocationsError, <<~GRAPHQL
-          fragment LocationsError on LocationsError {
-            message
-            conflictingIds
-            validationErrors {
-              property
-              error
-              message
-            }
-          }
-        GRAPHQL
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      class Fragment
+        fragment :LocationsError, <<~GRAPHQL
+          fragment LocationsError on LocationsError {
+            message
+            conflictingIds
+            validationErrors {
+              property
+              error
+              message
+            }
+          }
+        GRAPHQL
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/fragment/page.rb

@@ -18,6 +18,7 @@ module Ecoportal
             draft
             externalId
             timeZone
+            baseTags
             otherTags
             taskPriority
             sourceTemplateId

data/lib/ecoportal/api/graphql/fragment/pages/common_page_union.rb

@@ -61,6 +61,7 @@ module Ecoportal
             fragment stageAttrs on Stage {
               id @skip(if: $only_content)
               name
+              tags
               ...sectionsFragment
               active
               started
@@ -85,6 +86,7 @@ module Ecoportal
               name
               uid
               locations { ...locationNode }
+              baseTags  @include(if: $content)
               otherTags @include(if: $content)
               timeZone
               updatedAt { dateTime        }
@@ -97,7 +99,7 @@ module Ecoportal
               # `templateContainerUid` is the SERIES key: many versions may carry the same uid,
               # but only one may be published (`active: true`) per organization at a time —
               # publishing another with the same uid unpublishes the incumbent. See
-              # `.ai-assistance/code/ecoPortal_architecture/02_data_model.md`.
+              # the repo's internal docs.
               template @skip(if: $only_content) {
                 templateContainerUid
                 active
@@ -135,7 +137,7 @@ module Ecoportal
               # per-type members carry no description, so `updatePage` cannot set it.
               #
               # Integrations use it as a pseudo external-id on fields (we do so on templates;
-              # M&S do so on page instances — confirmed working on instances with a
+              # customers do so on page instances — confirmed working on instances with a
               # non-superuser service account, 2026-07-31). Fetched by default so those
               # integrations can read it back.
               description       @skip(if: $only_content)
@@ -241,11 +243,16 @@ module Ecoportal
 
             fragment imageGalleryField on ImageGallery {
               images @include(if: $content) {
+                id
+                weight
                 downloadUrl
                 caption
                 fileName
                 fileSize
-                uploadId @skip(if: $only_content)
+                uploadId                 @skip(if: $only_content)
+                sensitiveContent         @skip(if: $only_content)
+                inaccurateDescription    @skip(if: $only_content)
+                inaccurateExtractedText  @skip(if: $only_content)
               }
             }
 

data/lib/ecoportal/api/graphql/fragment/pages.rb

@@ -1,15 +1,15 @@
-module Ecoportal
-  module API
-    class GraphQL
-      class Fragment
-        class Pages
-          include Ecoportal::API::GraphQL::Concerns::FragmentDefinitions
-        end
-
-        register_namespace Pages
-      end
-    end
-  end
-end
-
-require_relative 'pages/common_page_union'
+module Ecoportal
+  module API
+    class GraphQL
+      class Fragment
+        class Pages
+          include Ecoportal::API::GraphQL::Concerns::FragmentDefinitions
+        end
+
+        register_namespace Pages
+      end
+    end
+  end
+end
+
+require_relative 'pages/common_page_union'

data/lib/ecoportal/api/graphql/fragment/pagination.rb

@@ -1,17 +1,17 @@
-module Ecoportal
-  module API
-    class GraphQL
-      class Fragment
-        fragment :Pagination, <<~GRAPHQL
-          fragment Pagination on ActionConnection {
-            totalCount
-            pageInfo {
-              endCursor
-              hasNextPage
-            }
-          }
-        GRAPHQL
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      class Fragment
+        fragment :Pagination, <<~GRAPHQL
+          fragment Pagination on ActionConnection {
+            totalCount
+            pageInfo {
+              endCursor
+              hasNextPage
+            }
+          }
+        GRAPHQL
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/fragment/permissions.rb

@@ -58,13 +58,11 @@ module Ecoportal
             pageCanListDrafts { ...AuthorizationResult }
             pageCanRestore { ...AuthorizationResult }
             pageCanUseDrafts { ...AuthorizationResult }
-            pageSmartAssistantCanChat { ...AuthorizationResult }
             personSchemaCanAccessManager { ...AuthorizationResult }
             publicTemplatesCanCopyLink { ...AuthorizationResult }
             publicTemplatesCanIndex { ...AuthorizationResult }
             publicTemplatesCanListEntries { ...AuthorizationResult }
             publicTemplatesCanManage { ...AuthorizationResult }
-            registerAssistantCanChat { ...AuthorizationResult }
             registerCanAccessRegisterTools { ...AuthorizationResult }
             registerCanCreate { ...AuthorizationResult }
             registerCanLimitTemplates { ...AuthorizationResult }

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

@@ -0,0 +1,102 @@
+module Ecoportal
+  module API
+    class GraphQL
+      class Fragment
+        # Node selection for a TEMPLATE change-log entry — `template { commands { nodes } }`.
+        #
+        # The type condition is the INTERFACE `PagesWorkflowCommandInterface`
+        # (`app/graphql/types/pages/interfaces/workflow_command_interface.rb`, graphql_name set
+        # explicitly there). Spreading a fragment on an interface at an interface-typed location
+        # is legal; selecting a CONCRETE type's field (e.g. `changes`, `changeMessages`) is not,
+        # unless wrapped in an inline fragment. Everything below is therefore an interface field,
+        # plus `__typename` so callers can branch on the concrete command class.
+        #
+        # Deliberately NOT selected, and why:
+        # - `stage: StageType` and `task: TaskInterface` — object subtrees; `stageId`/`stageName`
+        #   and `taskId`/`taskType` already answer "which stage / which task" as scalars, and
+        #   both resolvers do an extra RecordLoader/EmbeddedObjectLoader round trip. Select them
+        #   explicitly with a custom connection block if you need the full objects.
+        # - the concrete-type extras (`changes { field from to }`, `changeMessages`) — see
+        #   `Fragment :PagesWorkflowCommandFields` in `fragment/pages_workflow.rb`, which already
+        #   models them for the workflow-builder side of the same interface.
+        #
+        # See `Base::Template::ChangeLogEntry` for the two access caveats (nil-when-unpermitted,
+        # TEMPLATE_BUILDER-only) and the forces watermark blind spot.
+        fragment :TemplateChangeLogEntry, <<~GRAPHQL
+          fragment TemplateChangeLogEntry on PagesWorkflowCommandInterface {
+            __typename
+            id
+            commandAction
+            patchVer
+            createdAt {
+              dateTime
+              timeZone
+            }
+            updatedAt {
+              dateTime
+              timeZone
+            }
+            ownerId
+            owner {
+              id
+              name
+              email
+            }
+            stageId
+            stageName
+            taskId
+            taskType
+            targetedResourceId
+            targetedResourceName
+            targetedResourceType
+          }
+        GRAPHQL
+
+        # DETAIL selection — the same entry PLUS what actually changed.
+        #
+        # Opt in to this only when you need it: it costs three inline fragments and their
+        # sub-selections on every node. `Query::TemplateChangeLog.detail_block` and
+        # `api.template.change_log(detail: true)` both use it; the light
+        # `:TemplateChangeLogEntry` above stays the default so "who changed this, and when"
+        # does not pay for per-type detail.
+        #
+        # ★ The three concrete types report changes DIFFERENTLY, verified against the backend
+        # (2026-08-20) — this is why one flat shape cannot describe them:
+        # - `PagesWorkflowCommandChange.changes: [ChangeType!]!` — `ChangeType` is
+        #   `{ field: String!, from: String, to: String }` (`app/graphql/types/change_type.rb`),
+        #   i.e. before/after as STRINGS. This is the common case.
+        # - `PagesWorkflowCommandChangeMessage.changeMessages` — pre-rendered human strings, no
+        #   field/from/to at all.
+        # - `PagesWorkflowCommandEsChange.changes: [StoredEsFilterChangeType!]!` where `from`/`to`
+        #   are `StoredEsFilterType` OBJECTS, not strings
+        #   (`app/graphql/types/stored_es_filter_change_type.rb`). Only `field` is selected here,
+        #   deliberately: naming which filter changed is useful, and `StoredEsFilterType`'s own
+        #   shape has not been verified, so selecting into it would be a guess. An ES-change entry
+        #   therefore tells you WHICH filter moved, not its before/after.
+        #   (Reached via `WorkflowCallbacks::EditTrigger` — see the interface's `resolve_type`.)
+        #
+        # So branch on `__typename` (or ask `entry.detail_kind`) before reading `changes`.
+        fragment :TemplateChangeLogEntryDetail, <<~GRAPHQL
+          fragment TemplateChangeLogEntryDetail on PagesWorkflowCommandInterface {
+            ...TemplateChangeLogEntry
+            ... on PagesWorkflowCommandChange {
+              changes {
+                field
+                from
+                to
+              }
+            }
+            ... on PagesWorkflowCommandChangeMessage {
+              changeMessages
+            }
+            ... on PagesWorkflowCommandEsChange {
+              changes {
+                field
+              }
+            }
+          }
+        GRAPHQL
+      end
+    end
+  end
+end

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

@@ -45,3 +45,4 @@ require_relative 'fragment/minimal_dashboard'
 require_relative 'fragment/field_configuration'
 require_relative 'fragment/page_task'
 require_relative 'fragment/template'
+require_relative 'fragment/template_change_log'

data/lib/ecoportal/api/graphql/helpers/locations_tree.rb

@@ -1,41 +1,41 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Helpers
-        module LocationsTree
-          RELEVANT_NODES_COUNT = 1_000
-
-          def treeify(nodes)
-            parents = nodes.each_with_object({}) do |node, out|
-              (out[node.parent_id_upcase] ||= []).push(node)
-            end
-
-            get_children(nil, parents)
-          end
-
-          private
-
-          def get_children(node_id, parents)
-            (parents[node_id&.upcase] ||= []).each_with_object([]) do |child, results|
-              class_types = child.classifications || []
-              class_ids   = class_types.map(&:id)
-              class_names = class_types.map(&:name)
-
-              results << {
-                'id'                   => child.id,
-                'name'                 => child.name,
-                'weight'               => child.weight,
-                'parent_id'            => node_id,
-                'archived'             => child.archived,
-                'archived_token'       => child.archivedToken,
-                'classifications'      => class_ids,
-                'classification_names' => class_names,
-                'nodes'                => get_children(child.id, parents).compact
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Helpers
+        module LocationsTree
+          RELEVANT_NODES_COUNT = 1_000
+
+          def treeify(nodes)
+            parents = nodes.each_with_object({}) do |node, out|
+              (out[node.parent_id_upcase] ||= []).push(node)
+            end
+
+            get_children(nil, parents)
+          end
+
+          private
+
+          def get_children(node_id, parents)
+            (parents[node_id&.upcase] ||= []).each_with_object([]) do |child, results|
+              class_types = child.classifications || []
+              class_ids   = class_types.map(&:id)
+              class_names = class_types.map(&:name)
+
+              results << {
+                'id'                   => child.id,
+                'name'                 => child.name,
+                'weight'               => child.weight,
+                'parent_id'            => node_id,
+                'archived'             => child.archived,
+                'archived_token'       => child.archivedToken,
+                'classifications'      => class_ids,
+                'classification_names' => class_names,
+                'nodes'                => get_children(child.id, parents).compact
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,10 +1,10 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Helpers
-      end
-    end
-  end
-end
-
-require_relative 'helpers/locations_tree'
+module Ecoportal
+  module API
+    class GraphQL
+      module Helpers
+      end
+    end
+  end
+end
+
+require_relative 'helpers/locations_tree'

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

@@ -1,14 +1,14 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        module Action
-          class Archive < Logic::Input
-            passkey :id
-            passthrough :updateMode
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        module Action
+          class Archive < Logic::Input
+            passkey :id
+            passthrough :updateMode
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,13 +1,13 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        module Action
-          class Create < Base::Action
-            passthrough :clientMutationId
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        module Action
+          class Create < Base::Action
+            passthrough :clientMutationId
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,14 +1,14 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        module Action
-        end
-      end
-    end
-  end
-end
-
-require_relative 'action/create'
-require_relative 'action/update'
-require_relative 'action/archive'
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        module Action
+        end
+      end
+    end
+  end
+end
+
+require_relative 'action/create'
+require_relative 'action/update'
+require_relative 'action/archive'

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

@@ -1,14 +1,14 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        module ContractorEntity
-          class Create < Base::ContractorEntity
-            passthrough :clientMutationId
-            passboolean :overrideAutoApproval
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        module ContractorEntity
+          class Create < Base::ContractorEntity
+            passthrough :clientMutationId
+            passboolean :overrideAutoApproval
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,13 +1,13 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        module ContractorEntity
-          class Destroy < Logic::Input
-            passkey :id
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        module ContractorEntity
+          class Destroy < Logic::Input
+            passkey :id
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,16 +1,16 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        # Maps DeltaInput for the pageDelta query.
-        # Pass as an array: [{ id: 'pageId', deltaAt: 'ISO8601DateTime' }, ...]
-        # deltaAt: the last-known timestamp for this page ID.
-        # Server returns UPDATED if the page changed after deltaAt, NOT_FOUND if deleted, NEW if unknown.
-        class DeltaInput < Logic::Input
-          passkey :id
-          passthrough :deltaAt
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        # Maps DeltaInput for the pageDelta query.
+        # Pass as an array: [{ id: 'pageId', deltaAt: 'ISO8601DateTime' }, ...]
+        # deltaAt: the last-known timestamp for this page ID.
+        # Server returns UPDATED if the page changed after deltaAt, NOT_FOUND if deleted, NEW if unknown.
+        class DeltaInput < Logic::Input
+          passkey :id
+          passthrough :deltaAt
+        end
+      end
+    end
+  end
+end

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

@@ -1,11 +1,11 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class IdDiff < Logic::BaseModel
-          passarray :additions, :removals
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class IdDiff < Logic::BaseModel
+          passarray :additions, :removals
+        end
+      end
+    end
+  end
+end

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

@@ -1,13 +1,13 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        module LocationStructure
-          class ArchiveCommand < Interface::LocationStructure::Command
-            passthrough :nodeId
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        module LocationStructure
+          class ArchiveCommand < Interface::LocationStructure::Command
+            passthrough :nodeId
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,13 +1,13 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        module LocationStructure
-          class DeleteCommand < Interface::LocationStructure::Command
-            passthrough :nodeId
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        module LocationStructure
+          class DeleteCommand < Interface::LocationStructure::Command
+            passthrough :nodeId
+          end
+        end
+      end
+    end
+  end
+end