ecoportal-api-graphql 1.3.17 → 2.2.1

data/lib/ecoportal/api/graphql/model/activity_log.rb

@@ -0,0 +1,31 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        # Concrete read model for a System Access Log entry. Adds the relational
+        # embeds on top of the common union fields in Base::ActivityLog.
+        #
+        # `parentResource*` and `resource` are present only on the Dashboard* union
+        # members (DashboardAccess/Create/Delete/Update, DeniedDashboardAccess);
+        # they are nullable here so page/file/scim members resolve cleanly.
+        class ActivityLog < Base::ActivityLog
+          # Lightweight wrapper for the union members' `resource { isVisible }` selection.
+          # Defined before the embeds_one below that references it.
+          class Resource < Logic::BaseModel
+            read_only!
+
+            passthrough :__typename
+            embeds_one :isVisible, klass: Model::AuthorizationResult, nullable: true
+          end
+
+          passthrough :parentResourceId, :parentResourceName, :parentResourceType
+
+          embeds_one :user, klass: Model::User, nullable: true
+          # resource: only `isVisible: AuthorizationResult` is selected (the web
+          # feature's shape); the full Dashboard subtree is not modelled here.
+          embeds_one :resource, klass: Model::ActivityLog::Resource, nullable: true
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/model/auth_log.rb

@@ -0,0 +1,11 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        class AuthLog < Base::AuthLog
+          embeds_one :targetUser, klass: Model::User
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/model/authorization_result.rb

@@ -0,0 +1,12 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        # Concrete model for a permission-check result. No extra wiring today; exists so
+        # `canXXX` fields embed `Model::AuthorizationResult` (and can grow a `reasons` model later).
+        class AuthorizationResult < Base::AuthorizationResult
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/model/minimal_dashboard.rb

@@ -0,0 +1,14 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        class MinimalDashboard < Base::MinimalDashboard
+          # owner: MinimalUser (id/email/name) — modelled with the User model.
+          embeds_one :owner, klass: Model::User
+          # register: MinimalRegister — Model::Register's read fields are a compatible superset.
+          embeds_one :register, klass: Model::Register
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/model/organization.rb

@@ -7,6 +7,13 @@ module Ecoportal
         class Organization < Base::Organization
           DEFAULT_PATH = ['currentOrganization'].freeze
 
+          # permissions: Permissions! — the org-level canXXX ability set (~83 AuthorizationResult
+          # fields, e.g. dashboardCanManage, locationStructuresCanAiGenerateStructure,
+          # generatedPageFilterCanUseSmartQuery). Typed read when a fetched doc includes it;
+          # fetch natively via the `permissions` query below.
+          embeds_one :permissions,
+                     klass: "Ecoportal::API::GraphQL::Model::Permissions", nullable: true
+
           class << self
             extend Ecoportal::API::Common::GraphQL::QueryIntegration
 
@@ -29,6 +36,35 @@ module Ecoportal
 
             query :contractorEntities,
               query_klass: 'Ecoportal::API::GraphQL::Query::ContractorEntities'
+            # System access logs (SCIM/security auditing) — AuthLogConnection
+            query :authLogs,
+              query_klass: 'Ecoportal::API::GraphQL::Query::AuthLogs'
+            # Org-level permission set (canXXX abilities) — Permissions
+            query :permissions,
+              query_klass: 'Ecoportal::API::GraphQL::Query::Permissions'
+            # System Access Logs feature — ActivityLogUnionConnection (rich filters:
+            # userIds/resourceIds/filterSuperusers/activityType/resourceType/source/dateFilter)
+            query :activityLogs,
+              query_klass: 'Ecoportal::API::GraphQL::Query::ActivityLogs'
+            # Page history / activity feed — ActivityInterfaceConnection.
+            # Resolves currentOrganization.page(id:).activities; pass `id:` (page id).
+            # ★ `subpath: 'page'` is REQUIRED. `QueryIntegration#query` always injects
+            # `base_path: path + [subpath]` into the query instance, and
+            # `BaseQuery#initialize` takes that keyword in preference to the class-level
+            # `base_path` declaration — so `Query::PageActivities`' own
+            # `base_path 'currentOrganization.page'` is overridden, not honoured. Without
+            # the subpath the response is dug at `currentOrganization.activities`, a path
+            # the emitted document never contains (the inline-fragment `activities` merges
+            # into `page`), and every call returns empty.
+            query :pageActivities,
+              subpath:     'page',
+              query_klass: 'Ecoportal::API::GraphQL::Query::PageActivities'
+            # Person member changelog history — PersonMemberChangelogConnection
+            query :personMemberChangelogs,
+              query_klass: 'Ecoportal::API::GraphQL::Query::PersonMemberChangelogs'
+            # Dashboard search — MinimalDashboardConnection
+            query :dashboardSearch,
+              query_klass: 'Ecoportal::API::GraphQL::Query::DashboardSearch'
             #contractorEntity,
             query :actionCategories,
               query_klass: 'Ecoportal::API::GraphQL::Query::ActionCategories'

data/lib/ecoportal/api/graphql/model/page/phased.rb

@@ -24,6 +24,8 @@ module Ecoportal
               embedded = super
               # Share the page's canonical field objects with each stage, so mutations made
               # via stage.components reach the page's data_fields_updates (phased write-path).
+              # NOTE: no manual `page` back-ref injection — Stage#page resolves the owning page
+              # via the DoubleModel's native `root` reference (page -> stages collection -> stage).
               fc = field_collection
               Array(embedded).each do |st|
                 st.page_field_collection = fc if st.respond_to?(:page_field_collection=)
@@ -31,6 +33,21 @@ module Ecoportal
               Compat::StageCollection.new(embedded)
             end
 
+            # Page-level compiled tag set (client-side build of the backend-only
+            # "compiled_tags"), per the domain formula:
+            #
+            #   Page.all_tags = Unique(⋃ all stages' all_tags)
+            #
+            # De-duplicated Array of tag strings across every stage. A phased page with no
+            # stages falls back to the page-level components (baseTags + otherTags +
+            # location_ids), matching the basic-page behaviour on Interface::BasePage.
+            def all_tags
+              stgs = Array(stages)
+              return super if stgs.empty?
+
+              stgs.flat_map(&:all_tags).compact.uniq
+            end
+
             # v2 compatible: ID of the stage with state == 'inprogress', or nil
             def current_stage_id
               raw = doc['stagesIndex'] || doc['stages']

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

@@ -0,0 +1,185 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        # Org-level permission set (Organization.permissions). Each `canXXX` field is an
+        # AuthorizationResult (`{ value message }`); all are non-null in the schema but modelled
+        # nullable so a partial selection (fetching only some canXXX) still reads cleanly.
+        class Permissions < Base::Permissions
+          embeds_one :actionCanCreateStandalone,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :actionCanIndex,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :alertNotificationCanAccessBroadcastNotifications,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :alertNotificationCanCreate,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :alertNotificationCanIndex,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :canAccessAdminTools,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :canAccessPeopleManager,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :canDeleteActionCategories,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :canIndex,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :canListAttachablePersonMembers,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :canManageActionCategories,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :canManageStandaloneActionsPermissions,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :canResetActionsCounter,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :canUpload,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :contractorEntityCanAccessContractorManager,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :contractorEntityCanAttach,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :contractorEntityCanCreate,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :contractorEntityCanDestroy,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :contractorEntityCanEdit,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :contractorEntityCanEditLinkedUsers,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :contractorEntityCanIndex,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :contractorEntityCanManageParentContractors,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :contractorEntityCanManageSubcontractors,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :crossReferenceReportsCanIndex,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :dashboardCanManage,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :dataSetsCanIndex,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :dataSpaceCanShow,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :dataViewsCanIndex,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :emailReportCanConfigureSmartReport,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :filesCanIndex,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :filesCanUpload,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :generatedPageFilterCanCreate,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :generatedPageFilterCanUseSmartQuery,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :hasFileAbilityToDownload,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :locationClassificationsCanCreate,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :locationClassificationsCanUpdate,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :locationStructuresCanAccess,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :locationStructuresCanAdministrate,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :locationStructuresCanAiGenerateStructure,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :locationStructuresCanCreate,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :locationStructuresCanManage,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :locationStructuresCanManageSftpIntegration,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :locationStructuresCanPublish,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :locationStructuresCanRead,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :locationStructuresCanScheduleUpdate,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :locationStructuresCanUpdate,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :organizationCanViewSettings,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :pageAiSummaryCanAccess,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :pageCanListDrafts,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :pageCanRestore,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :pageCanUseDrafts,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          # DEPRECATED (20260929): removed from the live schema by the smart-assistant
+          # consolidation; no longer selected by Fragment::Permissions, so always nil. Kept so
+          # callers get nil instead of NoMethodError.
+          embeds_one :pageSmartAssistantCanChat,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :personSchemaCanAccessManager,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :publicTemplatesCanCopyLink,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :publicTemplatesCanIndex,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :publicTemplatesCanListEntries,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :publicTemplatesCanManage,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          # DEPRECATED (20260929): removed from the live schema by the smart-assistant
+          # consolidation; no longer selected by Fragment::Permissions, so always nil. Kept so
+          # callers get nil instead of NoMethodError.
+          embeds_one :registerAssistantCanChat,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :registerCanAccessRegisterTools,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :registerCanCreate,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :registerCanLimitTemplates,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :scimIntegrationCanAddCodeHooks,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :scimIntegrationCanCreate,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :scimIntegrationCanDestroy,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :scimIntegrationCanGenerateApiKey,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :scimIntegrationCanIndex,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :scimIntegrationCanShow,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :scimIntegrationCanShowLogs,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :scimIntegrationCanUpdate,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :spatialCanUpdateLocationNodeGeojson,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :structuresCanIndex,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :templateCanRestore,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :userAccessLogsCanShow,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :userCanAccessAdminArea,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :userCanAccessPageCreationTools,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :visitorLogCanAdminCheckIn,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :visitorLogCanEdit,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :visitorLogCanManage,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :visitorLogCanShow,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :visitorManagementCanAccessVisitorManager,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :visitorManagementCanIndex,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :webhooksCanManageSubscriptions,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+          embeds_one :webhooksCanViewSubscriptions,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/model/person_member.rb

@@ -6,6 +6,13 @@ module Ecoportal
           embeds_one :contractorOrganization, klass: "Ecoportal::API::GraphQL::Model::ContractorEntity"
           embeds_one :account, klass: Model::Account
 
+          # changelogs: [PersonMemberChangelog!] — audit history for this member.
+          embeds_many :changelogs, klass: "Ecoportal::API::GraphQL::Model::PersonMemberChangelog"
+
+          # canManageContractorAdmins: AuthorizationResult — permission check (nullable).
+          embeds_one :canManageContractorAdmins,
+                     klass: "Ecoportal::API::GraphQL::Model::AuthorizationResult", nullable: true
+
           # embeds_many :privateFields, enum_class: Ecoportal::API::GraphQL::Model::MemberSchemaFields
           # embeds_many :publicFields, enum_class: Ecoportal::API::GraphQL::Model::MemberSchemaFields
         end

data/lib/ecoportal/api/graphql/model/person_member_changelog.rb

@@ -0,0 +1,15 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        class PersonMemberChangelog < Base::PersonMemberChangelog
+          # `personMember` is a PreviewPersonMember (id/name/email) — modelled with the
+          # PersonMember model, whose read fields are a compatible superset.
+          embeds_one :personMember, klass: Model::PersonMember
+          # `user` is a MinimalUser (id/email/name) — modelled with the User model.
+          embeds_one :user, klass: Model::User
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/model/template/change_log_entry.rb

@@ -0,0 +1,19 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        module Template
+          # Concrete read model for one entry of a template's change log. Adds the relational
+          # embed on top of the interface fields modelled in `Base::Template::ChangeLogEntry`
+          # (which is where the platform caveats are documented — read them before using this).
+          class ChangeLogEntry < Base::Template::ChangeLogEntry
+            # `owner` is a `UserType` (id / name / email) — WHO made the change. Resolved
+            # server-side from `owner_id` via RecordLoader, so it is nil for system-originated
+            # commands with no user. Prefer `owner&.name` over `ownerId` for reporting.
+            embeds_one :owner, klass: Model::User, nullable: true
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/model/template.rb

@@ -3,11 +3,14 @@ module Ecoportal
     class GraphQL
       module Model
         # Concrete counterparts of `Base::Template::*` (see there for the page-vs-Template
-        # type asymmetry). No extra wiring needed — both are flat, read-only models.
+        # type asymmetry). `Information` and `RelatedPages` need no extra wiring — both are
+        # flat, read-only models; `ChangeLogEntry` adds the `owner` embed.
         module Template
           class Information < Base::Template::Information; end
 
           class RelatedPages < Base::Template::RelatedPages; end
+
+          require_relative 'template/change_log_entry'
         end
       end
     end

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

@@ -20,11 +20,20 @@ require_relative 'model/page_union'
 require_relative 'model/preview_page'
 require_relative 'model/resource'
 require_relative 'model/action'
+require_relative 'model/action_event_page'
+require_relative 'model/action_event'
 require_relative 'model/contractor_entity'
+require_relative 'model/authorization_result'
+require_relative 'model/permissions'
+require_relative 'model/activity'
+require_relative 'model/activity_log'
+require_relative 'model/auth_log'
+require_relative 'model/person_member_changelog'
 require_relative 'model/organization'
 
 require_relative 'model/register'
 require_relative 'model/preset_view'
+require_relative 'model/minimal_dashboard'
 
 require_relative 'model/ai_summary_version'
 require_relative 'model/pages_workflow'

data/lib/ecoportal/api/graphql/mutation/ai_summary/generate.rb

@@ -3,27 +3,38 @@ module Ecoportal
     class GraphQL
       module Mutation
         module AiSummary
-          # Triggers AI summary generation for a page or stage.
-          # Returns an AiSummaryVersion with the generated text and token usage.
-          # Generation is synchronous — the response contains the result or an error.
+          # Triggers AI summary generation for a page or stage. Returns an `AiSummaryVersion`.
           #
-          # stageId is optional: omit for page-level summary, provide for stage-level.
+          # ★ Corrected 2026-07-30 against the live schema — the previous wiring could never run:
+          # the mutation is `generatePageSummary(input: GenerateInput!)`, NOT `generateAiSummary`
+          # with flat `pageId`/`stageId` arguments, and `AiSummaryVersion` has no token fields.
+          #
+          # `stage_id` is optional: omit for a page-level summary, pass it for stage-level.
           class Generate < Logic::Mutation
-            field_name :generateAiSummary
+            field_name :generatePageSummary
 
             class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::AiSummaryGenerate'
 
+            def query(page_id:, stage_id: nil, **kargs, &block)
+              input = { pageId: page_id }
+              input[:stageId] = stage_id if stage_id
+              super(input: input, **kargs, &block)
+            end
+
             private
 
             def basic_block(&block)
               payload_block = block || default_payload_block
               proc {
-                mutation(pageId: :id!, stageId: :id) {
-                  generateAiSummary(pageId: :pageId, stageId: :stageId, &payload_block)
+                mutation(input: :GenerateInput!) {
+                  generatePageSummary(input: :input, &payload_block)
                 }
               }
             end
 
+            # AiSummaryVersion exposes: aiSummary, alreadyRated, createdAt, dataFieldLogs,
+            # generationErrors, id, pagePatchVer, status. Only the plain scalars are selected —
+            # `dataFieldLogs` / `generationErrors` / `createdAt` need their own selections.
             def default_payload_block
               proc {
                 errors { details fullMessages }
@@ -31,9 +42,8 @@ module Ecoportal
                   id
                   aiSummary
                   status
-                  inputTokens
-                  outputTokens
-                  totalTokens
+                  alreadyRated
+                  pagePatchVer
                 }
               }
             end

data/lib/ecoportal/api/graphql/mutation/ai_summary/submit_feedback.rb

@@ -3,25 +3,40 @@ module Ecoportal
     class GraphQL
       module Mutation
         module AiSummary
-          # Submit a thumbs-up / thumbs-down rating on an AI summary version.
-          # sentiment: "THUMBS_UP" | "THUMBS_DOWN"
-          # aiSummaryVersionId: returned from generateAiSummary.item.id
+          # Submit a rating on an AI summary version.
+          #
+          # ★ Corrected 2026-07-30 against the live schema — the previous wiring could never run:
+          # the mutation is `submitPageAiSummaryFeedback(input: SubmitFeedbackInput!)`, the enum is
+          # `SentimentEnum` (there is no `AiSummarySentimentEnum`), and its values are
+          # **`positive` / `negative`** — not the "THUMBS_UP"/"THUMBS_DOWN" this used to document.
+          #
+          # `ai_summary_version_id` comes from `generatePageSummary`'s `item.id`.
           class SubmitFeedback < Logic::Mutation
-            field_name :submitAiSummaryFeedback
+            SENTIMENTS = %w[positive negative].freeze
+
+            field_name :submitPageAiSummaryFeedback
 
             class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::OkPayload'
 
+            def query(ai_summary_version_id:, sentiment:, **kargs, &block)
+              unless SENTIMENTS.include?(sentiment.to_s)
+                raise ArgumentError, "sentiment must be one of #{SENTIMENTS.join(' / ')}; got #{sentiment.inspect}"
+              end
+
+              super(
+                input: { aiSummaryVersionId: ai_summary_version_id, sentiment: sentiment.to_s },
+                **kargs,
+                &block
+              )
+            end
+
             private
 
             def basic_block(&block)
               payload_block = block || default_payload_block
               proc {
-                mutation(aiSummaryVersionId: :id!, sentiment: :AiSummarySentimentEnum!) {
-                  submitAiSummaryFeedback(
-                    aiSummaryVersionId: :aiSummaryVersionId,
-                    sentiment:          :sentiment,
-                    &payload_block
-                  )
+                mutation(input: :SubmitFeedbackInput!) {
+                  submitPageAiSummaryFeedback(input: :input, &payload_block)
                 }
               }
             end

data/lib/ecoportal/api/graphql/mutation/contractor_entity/update_manager_settings.rb

@@ -0,0 +1,37 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module ContractorEntity
+          # `updateContractorManagerSettings` mutation (2026-07 schema).
+          # Returns the updated Organization directly.
+          class UpdateManagerSettings < Ecoportal::API::GraphQL::Logic::Mutation
+            field_name :updateContractorManagerSettings
+
+            class_resolver :payload_class, Payload::ContractorEntity::ManagerSettings
+            class_resolver :input_class, Input::ContractorEntity::ManagerSettings
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :UpdateContractorManagerSettingsInput!) {
+                  updateContractorManagerSettings(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                id
+                name
+                allowContractorAdminsToAddAdmins
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/mutation/contractor_entity.rb

@@ -12,3 +12,4 @@ end
 require_relative 'contractor_entity/create'
 require_relative 'contractor_entity/destroy'
 require_relative 'contractor_entity/update'
+require_relative 'contractor_entity/update_manager_settings'